Jellyfin Status

Jellyfin to Awtrix NG (Node-RED Flow)

This simple Node-RED flow connects to your Jellyfin API and displays what is currently playing (with a smooth progress bar) on your Awtrix NG matrix.

How to use:

1. Import the JSON flow into your Node-RED.
2. Double-click the HTTP Request node and update the URL with your details:

• Replace JELLYFIN_IP with your Jellyfin server IP.
• Replace YOUR_API_KEY with your API key generated in Jellyfin (Dashboard -> Advanced -> API Keys).

3. Double-click the MQTT Out node and select your own MQTT Broker.

• Note: Make sure the topic matches your Awtrix prefix (default is awtrix-ng/cmd/apps/pushed/Jellyfin).

4. Click Deploy and you're good to go!

UPDATE 1. 30/08/26

• User Whitelist Feature
  Added a simple configuration to filter playback by user. The matrix will now only display media watched by the specific accounts you define (e.g., ignoring kids' or guests' accounts).
  You have to edit "1. Check CJK & Route" node to add users
• Smart CJK (Asian Characters) Fix
  The Awtrix matrix cannot render Chinese, Japanese, or Korean characters (displays ???). The flow now automatically detects CJK characters in the title.
• Cinemeta API Integration for Titles
  When Asian characters are detected, the flow automatically extracts the IMDb ID from Jellyfin and silently fetches the clean Western title (English/Polish) using the free Cinemeta API. Regular titles bypass this step for maximum speed.
• Title Caching System
  Added an internal Node-RED memory cache. External APIs are queried only once per movie/episode. Subsequent 5-second progress bar updates use the cached title to prevent network spam and IP bans.

UPDATE 2. 30/08/26

• Deleting app from loop when no playing active
  Just forgot to add empty payload, now it's working.

UPDATE 3. 07/10/26

• Updated API authentication for Jellyfin 12 compatibility
  Moved the API key from the URL parameter to the Authorization HTTP header to comply with the new security requirements.