Skip to main content

Mopidy extension for playing music from jellyfin

Project description

Latest PyPI version

Mopidy extension for playing audio files from Jellyfin


  • Supports both “Music” and “Book” media types
  • Tested using ncmpcpp, M.A.L.P., and various mopidy web frontends.
    • When using ncmpcpp, it’s recommended to set mpd_connection_timeout = 30, particularly if browsing folders that have a large number of items inside them
    • There is some inconsistency in M.A.L.P. where you may have to go to the menu and select ‘Show All Tracks’ for the library to populate properly
  • MPDroid on Android does not work properly


Install by running:

pip install Mopidy-Jellyfin

Mopidy-Jellyfin has officially moved to Python 3 with the release of Mopidy 3.0. All future updates will target this newer version.


Before starting Mopidy, you must add configuration for Mopidy-Jellyfin to your Mopidy configuration file:

hostname = Jellyfin server hostname
username = username
password = password
libraries = Library1, Library2 (Optional: will default to "Music" if left undefined)
albumartistsort = False (Optional: will default to True if left undefined)
album_format = {ProductionYear} - {Name} (Optional: will default to "{Name}" if left undefined)
max_bitrate = number
  • libraries determines what is populated into Mopidy’s internal library (view by Artists/Album/etc). Using the file browser will show all libraries in the Jellyfin server that have a ‘music’ type.

  • albumartistsort changes whether the media library populates based on “Artist” or “Album Artist” metadata

  • album_format can be used to change the display format of music albums when using the file browser view. Currently the only really usable fields are ProductionYear and Name

    max_bitrate is used to trigger transcoding if a file is over a given bitrate (in kbps)


  1. Install mopidy to your host system, preferably using the native package manager. This handles all of the required dependencies.

  2. Clone the repo to your local workstation

    $ git clone && cd mopidy-jellyfin

  1. Set up a virtualenv. We need to include system packages since some things don’t behave well inside of a virtualenv (such as PyGObject or interacting with pulseaudio). Note that with the release of Mopidy 3.0 only Python 3.7 or newer is supported.

    $ python -m venv env --system-site-packages

  2. Install mopidy-jellyfin to the virtualenv.

    $ env/bin/python develop

  3. Do your thing.

    Mopidy can be launched from the virtualenv with env/bin/mopidy

Project resources


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for Mopidy-Jellyfin, version 1.0.2
Filename, size File type Python version Upload date Hashes
Filename, size Mopidy-Jellyfin-1.0.2.tar.gz (26.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page