-
Notifications
You must be signed in to change notification settings - Fork 44
Seerr Setup
Seerr integration is optional. It runs through the Moonfin server plugin, which proxies requests through your Jellyfin server and avoids the CORS and cookie problems that TV webviews have with a direct connection.
- Install the Moonfin Plugin on your Jellyfin server.
- In the Jellyfin admin dashboard, open the plugin's configuration and, under Integrations, enter your Seerr server URL and enable Seerr. There is no API key to enter.
- On your TV, open Settings, Plugin, and enable the Moonfin plugin.
- Still on the TV, sign in to Seerr once. Enter your credentials and choose how to authenticate, either your Jellyfin account or a local Seerr account.
You never enter a Seerr URL or API key on the TV, the plugin already knows how to reach Seerr. After that first sign-in, the plugin keeps your Seerr session on the server, so switching users or reopening the app reconnects you automatically.
The plugin acts as a server-side proxy, so your TV only ever needs to reach your Jellyfin server. Seerr itself does not need to be reachable from the TV, which means it can stay on an internal network or behind a reverse proxy that the TV cannot see.
Your TV talks to the plugin using your Jellyfin access token rather than cookies, because cross-origin cookies do not persist in either platform's webview. The plugin holds your Seerr login session on the server and makes requests to Seerr on your behalf.
Once enabled, Seerr shows up throughout the app:
- Discover rows (Trending, Popular, Upcoming, My Requests, and more) that you can add to your home screen.
- A browse experience with filters for genre, studio, network, and keyword.
- Requesting in HD or 4K from the TV, with smart season selection for shows.
- Your pending, approved, and available requests in one place.
- Seerr results included in global search.
- Optional NSFW filtering using Seerr and TMDB metadata.
- If the Plugin settings page reports that the plugin is not detected, confirm the plugin is installed and enabled on the server and that the TV is signed in to that same server.
- If requests fail but browsing works, recheck the Seerr URL and API key in the plugin configuration on the server.
- If you run Jellyfin behind a reverse proxy, make sure it forwards the
/Moonfin/paths. See the plugin's Reverse Proxy and Seerr page.