Jellyfin Widget
Shows what is currently playing on your Jellyfin server, including title, user, progress bar, and cover art.
Requirements
- A running Jellyfin instance
- A Jellyfin API key
Getting an API key
- Open Jellyfin web interface
- Go to Dashboard → API Keys
- Click + to create a new key
- Give it a name (e.g. "Homepage") and copy the key
Configuration
Set both in the widget's own settings. There are no environment variables for these — the API key is stored encrypted and is never sent back to the browser, so the field will show as saved rather than displaying the key.
| Key | Type | Description |
|---|---|---|
jellyfinUrl | string | Base URL, e.g. http://jellyfin:8096 |
apiKey | string | Jellyfin API key. Stored encrypted; see Security |
Artwork is fetched through the Homepage server rather than linked directly, so the API key does not appear in image URLs.
Troubleshooting
Widget shows nothing
- Verify something is actively playing — the widget only shows active sessions
- Check the URL is reachable from the server container (not just the browser)
- Confirm the API key is valid in Jellyfin Dashboard → API Keys