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

1. Open Jellyfin web interface
2. Go to Dashboard → API Keys
3. Click + to create a new key
4. Give it a name (e.g. "Homepage") and copy the key

Configuration

Credentials can be set via environment variables (server-wide) or per-widget config. Widget config takes precedence.

Key	Type	Description
jellyfinUrl	string	Base URL, e.g. http://jellyfin:8096
apiKey	string	Jellyfin API key

Environment variable fallback:

JELLYFIN_URL=http://jellyfin:8096
JELLYFIN_API_KEY=your-key-here

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