Skip to content

About

MagicMirror² module showing the latest movies and series of a Jellyfin server

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

MMM-Jellyfin

A MagicMirror² module that shows the latest movies and series of your Jellyfin server with poster, year, type and tagline.

🇩🇪 Deutsche Anleitung

List (maxItemsShown: 3, posterWidth: 70) One title at a time (maxItemsShown: 1)
List Single title

Features

  • Latest movies and/or series with poster, year, type and tagline
  • Rotates through the list when there are more titles than fit
  • Several libraries (parentIds), several instances side by side
  • Works with the current Jellyfin authentication (10.11 and newer), the API key never ends up in the web page
  • Translations: English, German

Installation

cd ~/MagicMirror/modules
git clone https://github.com/meni555/MMM-Jellyfin.git

There is nothing to npm install. Requires MagicMirror² with Node.js 18 or newer.

Create an API key

In Jellyfin: Dashboard → API Keys → +, name it e.g. MagicMirror and copy the key.

Configuration

{
    module: "MMM-Jellyfin",
    position: "top_left",
    config: {
        serverUrl: "http://jellyfin.local:8096",
        apiKey: "YOUR_API_KEY",
        maxItemsShown: 3,
    }
},
Option Default Description
serverUrl "" Required. URL of your Jellyfin server incl. port
apiKey "" Required. Jellyfin API key
userId "" Whose library to show. Empty = userName, empty too = first administrator
userName "" User name instead of userId
parentIds [] Only these libraries (IDs), e.g. ["f137a2dd21bbc1b99aa5c0f6bf02a805"]
limit 10 Number of titles fetched
includeMovies true Show movies
includeSeries true Show series
maxItemsShown 5 Titles shown at the same time; more are rotated
rotateInterval 10000 Rotation interval in ms
updateInterval 900000 Fetch interval in ms (15 min)
showPoster true Show the poster
posterWidth 120 Poster width in px
showYear true Show the release year
showType true Show "Movie"/"Series"
showTagline true Show the tagline if there is one
header translated "Recently added" Header text; the module-level header works as well

Finding user and library IDs

curl -s -H 'Authorization: MediaBrowser Token="YOUR_API_KEY"' http://jellyfin.local:8096/Users \
  | python3 -c 'import json,sys; [print(u["Id"], u["Name"]) for u in json.load(sys.stdin)]'
curl -s -H 'Authorization: MediaBrowser Token="YOUR_API_KEY"' "http://jellyfin.local:8096/Users/USER_ID/Views" \
  | python3 -c 'import json,sys; [print(v["Id"], v["Name"]) for v in json.load(sys.stdin)["Items"]]'

Notes

  • Since Jellyfin 10.11 the old X-Emby-Token header and ?api_key= URLs are rejected with 401. This module uses the Authorization: MediaBrowser Token="…" header.
  • Posters are loaded without the API key (Jellyfin serves images without authentication), so the key is not visible in the browser. It is still part of your config.js, keep that file private.

License

MIT. This module is not affiliated with the Jellyfin project.

About

MagicMirror² module showing the latest movies and series of a Jellyfin server

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages