A MagicMirror² module that shows the latest movies and series of your Jellyfin server with poster, year, type and tagline.
List (maxItemsShown: 3, posterWidth: 70) |
One title at a time (maxItemsShown: 1) |
|---|---|
![]() |
![]() |
- 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
cd ~/MagicMirror/modules
git clone https://github.com/meni555/MMM-Jellyfin.gitThere is nothing to npm install. Requires MagicMirror² with Node.js 18 or newer.
In Jellyfin: Dashboard → API Keys → +, name it e.g. MagicMirror and copy the key.
{
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 |
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"]]'- Since Jellyfin 10.11 the old
X-Emby-Tokenheader and?api_key=URLs are rejected with401. This module uses theAuthorization: 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.
MIT. This module is not affiliated with the Jellyfin project.

