Skip to content

Plex FUSE Filesystem: Mount Plex Media Server as local filesystem

License

Notifications You must be signed in to change notification settings

glensc/plex-fuse

Repository files navigation

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