Plex FUSE Filesystem - Mount Remote Plex Media Server contents as local filesystem


Keywords
fuse, filesystem, fs, plex, fuse-filesystem, user-space
License
Other
Install
pip install plex-fuse==0.9.1

Documentation

Plex FUSE Filesystem

An attempt to create fuse filesystem to access Plex Media Server files as local files.

Development

This project is in very early development.

Currently implemented:

  • Listing of root directory
  • Connecting to PMS via python-plexapi
  • Listing of library types in root directory
  • Listing library titles in library type sub-directory
  • Listing titles from a library
  • Listing of Movie files
  • Report file size for media part
  • Report accurate nlink for directories
  • Memoize readdir and getattr calls
  • Fix "/" in directory names
  • Download movie files to cache, serve read operations from cache
  • Add -o cache_path option
  • Test that Plex Media Server allows requesting file by range
  • Use chunked read for file cache
  • Listing of Show seasons
  • Listing of Season episodes
  • Listing of Episode files
  • Downloading episode files
  • Unicode normalize titles
  • Support .plexmatch for Movies
  • Support timestamps for Movies
  • Support .plexmatch for Show directories
  • Add movie timestamps to .plexmatch files
  • Add timestamps to directories
  • Add subtitle files for Movies
  • Add subtitle files for Episodes
  • Cache PlexAPI requests using requests-cache (-o http_cache)
  • Publish package to pypi
  • Add docker volume driver
  • Add cache management (max size?)
  • Add cache purge option (special file?)
  • Detect need to refresh cache (add event listener)
  • Handling of "artist" library type
  • Add "status" and "reload" control channels

Requirements

  1. Python >= 3.11
  2. fuse, macfuse, osxfuse or fuse-t depending on your OS

Installation

  1. Install pipx
  2. Install plex-fuse: pipx install plex-fuse

Usage

  1. Check requirements and installation
  2. Create config.ini for python-plexapi
  3. Mount the configured PMS somewhere, i.e plex-server: mkdir plex-server; plex-fuse plex-server -f
  4. Access the plex-server directory from another terminal
  5. umount or fusermount -u the directory to remove the plex-server mount

Plex Config

Create Plex configuration file:

# ~/.config/plexapi/config.ini

[auth]
server_baseurl = http://127.0.0.1:32400
server_token = XBHSMSJSDJ763JSm