Skip to content

Seerr Setup

RadicalMuffinMan edited this page Sep 27, 2026 · 5 revisions

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.

Setup

  1. Install the Moonfin Plugin on your Jellyfin server.
  2. 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.
  3. On your TV, open Settings > Integrations > Moonbase Plugin and turn on Enable Plugin. It should report the plugin as detected.
  4. Still on the TV, open Settings > Integrations > Seerr and sign in once. Choose Jellyfin to use your normal server login, or Local for a Seerr-only 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.

Why it works this way

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.

What you get

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 requests in one place as a poster grid you can filter by status, each with its type, who asked and when, and a download bar while it's on its way. The request dialog shows how many requests you have left.
  • Issue reporting with full comment threads, and collection browsing.
  • Films missing from a collection you own, in release order with a badge, so you can request them from the collection's page. Turn this off with Integrations > Seerr > Show Missing Collection Items.
  • Season availability badges on show pages, switched by Show Seerr Availability Badges in the same place.
  • Approving and declining requests from the TV if your account is a Seerr admin.
  • Seerr results included in global search.
  • Optional NSFW filtering using Seerr and TMDB metadata.

Troubleshooting

  • 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 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.

A title shows "4K - Deleted" but plays fine

That badge is Seerr's own report, not a Moonfin mistake. The cause and the fix are on Common Problems. Worth ruling out before filing a Moonfin issue.

Clone this wiki locally