Repository navigation
Seerr Setup
Seerr integration is optional. It lets you discover and request media without leaving your Roku, and it runs through the Moonfin server plugin rather than talking to Seerr directly.
- The Moonfin server plugin installed on your Jellyfin or Emby server.
- A Seerr instance on your network, see seerr.dev.
- Install the Moonfin server plugin on your Jellyfin or Emby server and configure your Seerr URL in the plugin settings. The URL lives on the server, so there's nothing to type on the Roku.
- On your Roku, open Settings, then Moonfin Plugin, and make sure Enable Plugin is on and reports the plugin as found. Then open Seerr and turn on Enable Seerr.
- Sign in under Account & Sign In. Choose Jellyfin Account, or Emby Account on an Emby server, and use the same username and password as your media server.
- Start browsing and requesting.
Authentication saves a permanent local API key, so your session persists and reconnects automatically the next time you open the app.
Once connected, Seerr shows up throughout the app:
- Browse trending, popular, and recommended movies and shows, with filters for genre, studio, network, and keyword.
- Request in HD or 4K, with smart season selection when requesting a show.
- A requests and issues screen showing everything pending, approved, and available, with a status chip on each.
- Home screen rows for trending, popular, upcoming, and your recent requests.
- Seerr results folded into global search.
- Rich backdrop images across the discovery screens.
- Seerr sits inside the normal detail screen, with its rows and tabs alongside everything else, so a title your server does not have opens the same screen as one it does.
Moonfin can filter adult content out of Seerr browse and search results using the metadata Seerr and TMDB provide. The Block NSFW Content toggle lives alongside the rest of the Seerr settings, and it syncs with the server.
If authentication fails, confirm that the plugin is installed and that Seerr is configured in the plugin settings on the server. Everything goes through the plugin, so the Roku only needs to reach your Jellyfin or Emby server.
If requests submit but never appear, check that the Jellyfin or Emby user you signed in with is linked to a Seerr user with request permissions.
Using Moonfin
Going deeper
For developers