Seerr Hub is a Kodi add-on that answers one question for any movie or show: "how do I watch this right now?"
Pick a title and it checks your own media server, the streaming services you can get in your country, and your Seerr / Jellyseerr / Overseerr server. Then it gives you one short menu:
- Play from Plex / Jellyfin / Emby if it's already in your library
- Open in Netflix / Disney+ / HBO Max / ... if it's on a streaming service and the app is installed (Android TV)
- Request in Seerr if you don't have it, and let your Radarr/Sonarr setup fetch it
- Watch the trailer right in Kodi, through Kodi's YouTube add-on
- (optional) Download - choose the release to pick the exact release yourself, then start watching while it downloads
- (optional) Download a whole season as one season pack, or let Sonarr fetch every episode
It works as its own add-on, as a "Watch or request" item in Kodi's context menu, and as a player for TMDb Helper, so it plugs straight into skins like Arctic Fuse 3 (example setup).
Note
Seerr Hub doesn't stream or scrape anything. It opens apps you already have, plays files from your own server, and sends requests to your own Seerr.
- Screenshots
- How it decides what to offer
- Requirements
- Install
- Quick start
- Settings in detail
- Plex, Jellyfin and Emby
- Downloads: pick a release and watch while it downloads
- Using it from skins and TMDb Helper
- Example setup: Arctic Fuse 3
- Streaming apps
- Troubleshooting
- Privacy
- Building and contributing
Screenshots are from Kodi 21 with the Arctic Fuse 3 skin on a PC. See Example setup: Arctic Fuse 3 for how it's configured. On Android TV the same menu also lists "Open in Netflix" and so on.
flowchart TD
A[Pick a movie, show or episode] --> B{In your media server?}
B -- yes, and in Kodi's library --> P[Play from Plex / Jellyfin / Emby]
B -- yes, but not synced to Kodi yet --> Q[Open the Plex / Jellyfin / Emby app]
A --> C{Streaming in your region?<br/>JustWatch}
C -- app installed --> S[Open in Netflix, Disney+, ...]
C -- app not installed --> T[Named in the title:<br/>'also on Paramount+']
A --> D{Already requested<br/>or downloading?}
D -- downloading --> W[Downloading 42% - Watch now]
D -- no --> R[Request in Seerr]
D -- not downloaded yet --> X[Download - choose the release...<br/>through Radarr / Sonarr]
Everything that applies is listed together, best option first. Nothing is ever started without you choosing it.
| Needed? | Notes | |
|---|---|---|
| Kodi 20 (Nexus) or newer | Yes | Tested on Kodi 21 (Omega) on Android TV and Linux. |
| Seerr, Jellyseerr or Overseerr | Yes | You need its address and API key. |
| Plex + PlexKodiConnect | Optional | For "Play from Plex". |
| Jellyfin / Emby (+ Jellyfin for Kodi) | Optional | For "Play from Jellyfin". |
| Radarr / Sonarr | Optional | Already connected to Seerr. Lets you pick the release yourself. |
| qBittorrent, Transmission or Deluge | Optional | For watching while it downloads. Any other client (SABnzbd, NZBGet, rTorrent...) still shows up in the Downloading list through Radarr/Sonarr. |
| Android TV device | Optional | Only Android can open other apps. On other systems the "Open in ..." options are just left out. |
| Kodi's YouTube add-on | Optional | For trailers. Seerr Hub offers to install it from Kodi's repository the first time. |
From the Mooseca repository (recommended: Kodi keeps it up to date by itself)
- In Kodi, go to Settings → System → Add-ons and turn on Unknown sources.
- Go to Settings → File manager → Add source, choose
<None>and enterthen name ithttps://mooseca.github.io/repository.mooseca/mooseca. - Go to Settings → Add-ons → Install from zip file → mooseca and pick
repository.mooseca-<version>.zip. - Go to Install from repository → Mooseca Repository → Video add-ons → Seerr Hub → Install.
- Open Add-ons → Video add-ons → Seerr Hub → Configure (or long-press → Settings).
From a zip (no automatic updates)
Download plugin.video.seerrhub-<version>.zip from the latest release, turn on Unknown sources as above, then use Install from zip file on it. On a TV box it's often easiest to put the zip on a network share or USB stick. To update, install the newer zip the same way. Your settings are kept.
You only need two settings to get going:
- Seerr address, e.g.
http://192.168.1.10:5055 - Seerr API key, from Seerr's web page: Settings → General → API Key
That's it. Leave Media server on Ask Seerr, and Seerr Hub uses whichever server Seerr is connected to. Open the add-on, try Search or Trending, and pick a title.
| Setting | What to put | Example |
|---|---|---|
| Seerr address | The address you open Seerr on, including the port | http://192.168.1.10:5055 |
| Seerr API key | Seerr → Settings → General → API Key | |
| Streaming region | Two-letter country code for streaming availability. Leave blank to use the region set in Seerr. | US, GB, AU, CA |
| Setting | What it does |
|---|---|
| Media server | Ask Seerr (default) uses Seerr's own setting. You can force Plex, Jellyfin, Emby or None (no library: just streaming apps and requests). |
| Server address | Jellyfin / Emby only, e.g. http://192.168.1.10:8096. Leave blank to use the Jellyfin for Kodi login. |
| API key | Jellyfin: Dashboard → API Keys → +. Emby: Settings → Advanced → API Keys. |
| User name | The user whose watched status should be updated. Leave blank if there's only one user. |
| Setting | What to put | Example |
|---|---|---|
| Client | qBittorrent, Transmission or Deluge | |
| Web UI address | The client's Web UI. Default ports: qBittorrent 8080, Transmission 9091, Deluge 8112. | http://192.168.1.10:9091 |
| User name / Password | qBittorrent / Transmission: leave blank if there's no login. Deluge only has a Web UI password (blank = Deluge's default, deluge). |
|
| Download folder as Kodi sees it | The client's default download folder, shared to Kodi. Read-only is fine. Sub-folders (categories, labels) are worked out automatically. | smb://nas/downloads/ or nfs://nas/downloads/ |
| Your download client | Pick releases | Downloading list | Watch while it downloads |
|---|---|---|---|
| qBittorrent | Yes | Yes, with what's playable | Yes |
| Transmission 4.1+ | Yes | Yes, with what's playable | Yes |
| Transmission 4.0 or older | Yes | Yes, with what's playable | Yes, but it can't download in order, so it's usually ready later |
| Deluge 2 | Yes | Yes, with what's playable | Yes |
| Anything else (SABnzbd, NZBGet, rTorrent, ...), or leave the address blank | Yes | Yes, progress and time left from Radarr/Sonarr's queue | No |
You can still pick releases without any client set up, because Radarr/Sonarr send them to whatever download client they use.
Seerr Hub plays titles from Kodi's own library. That gives you normal Kodi playback, resume points and subtitles, and your media server stays the one source of truth.
Install and sign in to PlexKodiConnect, and let it sync your libraries. Seerr Hub finds the title in the Kodi library that PlexKodiConnect builds, and uses PlexKodiConnect's login when it needs to talk to Plex. There's nothing to fill in.
Install Jellyfin for Kodi (from the Jellyfin repository) and sync your libraries. If it's signed in, Seerr Hub uses its login and you can leave the Jellyfin settings blank.
If you'd rather not use that add-on's login (or it's on a different user), fill in the Server address, API key and User name settings.
This works the same way as Jellyfin, using Emby for Kodi. Emby goes through the same code as Jellyfin but hasn't been tested on a real Emby server yet. Reports welcome.
If Seerr says a title is available but your Kodi library hasn't caught up, the menu says "In Plex - not in Kodi's library yet". On Android it offers to open the Plex / Jellyfin / Emby app instead.
This part is optional, and is for people who already run Radarr and Sonarr behind Seerr. Watching while it downloads also needs qBittorrent, Transmission or Deluge.
Download - choose the release... runs an interactive search in Radarr or Sonarr. These are the same servers, quality profile, root folder and tags that Seerr would use. You get a ranked list:
* WEBDL-2160p - 14.2 GB - 312 seeds <- best pick
Bluray-1080p - 9.8 GB - 84 seeds
WEBDL-1080p - 4.1 GB - no seeds
x Remux-2160p - 61.0 GB - 40 seeds <- outside your profile
Pick one to see the details (indexer, MB per minute against your size settings, bitrate, custom formats, and why Radarr/Sonarr would reject it) before you send it.
Releases are ranked by:
| Weight | ||
|---|---|---|
| Quality | 30% | Where it sits in your quality profile |
| Seeders | 30% | Full marks at 200+ |
| Size | 20% | How close it is to the preferred size in Radarr/Sonarr (MB per minute) |
| Custom formats | 15% | Your custom format score |
| Streamable | 5% | Fits under your torrent client's download speed limit, if you set one |
Releases with no seeders are pushed far down, and releases Radarr/Sonarr would reject always sort below the ones they'd accept. For TV, season packs come first, then each episode's releases in order (the episode you asked for at the very top), with the best one for each episode starred. When a torrent client is set up, only torrents are listed, since watching while downloading needs one.
For shows, Download a whole season... (or Download all of season 2... when you started from an episode) lists only season packs, ranked the same way. The top entry, Let Sonarr choose, marks every episode of the season as monitored and starts Sonarr's own season search: it grabs a pack if one passes your profile, otherwise the best release for each episode. If there are no packs at all, it offers that search straight away.
Once you pick a release, it goes to Radarr/Sonarr, so they import and rename it as usual. If the title isn't in Radarr/Sonarr yet, it's added first, without an automatic search. With a torrent client set up, Seerr Hub then waits for the torrent to appear and offers to watch it.
When you start watching a download, Seerr Hub:
- switches the torrent to sequential download (in qBittorrent and Deluge, first and last pieces first too) and starts it if it was queued or paused
- works out how much of the file is on disk from the start, with no gaps, and how fast it's downloading
- offers Watch now once the download is safely ahead of playback (20% margin, at least 90 seconds buffered), or Start by itself when it's safe, with a live progress window
The Downloading list shows every active download with progress and Watch now / Ready in ~12 min / Stalled. Without a torrent client set up it shows Radarr/Sonarr's queue instead: progress and done in ~25 min, for any download client including usenet. Each download has the title's poster and fanart (the episode's still for TV), its plot, and a progress bar on the artwork, so it looks like the rest of your library on the home screen.
Kodi's media server never sees playback of a file straight from the downloads folder. So Seerr Hub remembers how far you got. Every 10 minutes it checks, and once Radarr/Sonarr have imported the file and it shows up in Plex / Jellyfin / Emby, it marks it watched (past 90%) or saves your resume point there. Titles that never turn up are forgotten after 30 days.
Every movie, show, season and episode in Kodi gets a Watch or request (Seerr Hub) context-menu item. This covers library items, TMDb Helper lists and skin widgets.
Copy seerrhub.json to:
userdata/addon_data/plugin.video.themoviedb.helper/players/
Seerr Hub then shows up as a player in TMDb Helper. To make every Play button in a TMDb Helper-based skin (Arctic Fuse, Arctic Horizon...) go through Seerr Hub, set it as the default player for movies and episodes in TMDb Helper's settings.
Any Seerr Hub folder works as a widget:
| Widget | Path |
|---|---|
| Trending | plugin://plugin.video.seerrhub/?action=trending |
| Recommended movies | plugin://plugin.video.seerrhub/?action=recommended&type=movie |
| Recommended shows | plugin://plugin.video.seerrhub/?action=recommended&type=tv |
| My requests | plugin://plugin.video.seerrhub/?action=requests |
| Downloading | plugin://plugin.video.seerrhub/?action=downloads&reload=$INFO[Window(Home).Property(seerrhub.downloads)] |
Recommended comes from your own viewing: Seerr Hub takes the six movies (or shows) you watched last in Kodi's library, asks Seerr for each one's recommendations, and puts the titles recommended most often (and by the most recent ones) first. Anything you've already watched is left out. The list is kept for six hours, or until you watch something else.
The reload= part on the Downloading widget keeps it up to date: while something is downloading, the add-on changes that property every 30 seconds, which makes the skin reload the widget.
For a skin menu item that opens the Seerr Hub search keyboard straight away:
RunPlugin(plugin://plugin.video.seerrhub/?action=ask)
| Action | Path |
|---|---|
| Open the menu for a movie | plugin://plugin.video.seerrhub/?action=open&type=movie&tmdb_id=122917 |
| ...for an episode | plugin://plugin.video.seerrhub/?action=open&type=tv&tmdb_id=1396&season=1&episode=1 |
| Search with a word already filled in | plugin://plugin.video.seerrhub/?action=search&query=hobbit |
The screenshots come from Arctic Fuse 3 (with TMDb Helper and skinvariables, which it installs). Here's how Seerr Hub is wired into it, so you can copy the setup.
1. Every Play button goes through Seerr Hub. In TMDb Helper's settings, the default player is set to Seerr Hub for both movies and episodes (see TMDb Helper player). Pressing Play on anything in the skin, whether it's in your library or not, opens the Seerr Hub menu. TMDb Helper's built-in players are turned off, so it doesn't ask which player to use.
2. A "Search & Request" item in the menus. In the home, Movies, TV Shows and Discover sub-menus, an item labelled Search & Request, with the skin's magnifying-glass icon, runs:
RunPlugin(plugin://plugin.video.seerrhub/?action=ask)
3. Widgets. These are set in Arctic Fuse 3's menu and widget editor, using Poster style for the title rows:
| Menu | Widgets (in order) |
|---|---|
| Home | Continue Watching, Next Episodes, Downloading (Seerr Hub), New Movies, New Episodes, Trending (Seerr Hub), My Requests (Seerr Hub) |
| Movies | Your library (Continue Watching, Recently Added, Unwatched, ...) + TMDb Helper Trending This Week |
| TV Shows | Your library (Next Episodes, New Episodes, ...) + TMDb Helper Trending This Week |
| Discover (an extra menu item) | Trending Now (Seerr Hub), then "Popular on Netflix / Disney+ / Prime Video / ..." rows, Downloading, My Requests |
The Discover sub-menu also has Downloading and My Requests as full-screen lists:
ActivateWindow(videos,plugin://plugin.video.seerrhub/?action=downloads,return)
ActivateWindow(videos,plugin://plugin.video.seerrhub/?action=requests,return)
The "Popular on ..." rows are TMDb Helper's discover lists, filtered to one streaming service in your region. For example, Netflix (TMDb provider 8) in the US:
plugin://plugin.video.themoviedb.helper/?info=discover&tmdb_type=tv&with_watch_providers=8&watch_region=US
Because Play goes through Seerr Hub, picking anything in those rows offers Open in Netflix on Android TV. If the title is already in your library, it offers Play from Plex instead.
4. App shortcuts (Android TV). The home sub-menu also has plain launch items for the streaming apps (StartAndroidActivity(com.netflix.ninja) and so on), and one for the Plex app.
5. Tidier search (optional, Arctic Fuse 3.5+). Turn on Settings → Skin → Tidy Arctic Fuse 3 search. The skin's search page then loses the A-Z letter row under the search box (OK on the box opens Kodi's full keyboard), Back on the search box closes search, which is easier from a TV remote, and until you type something it shows Recommended movies and Recommended TV shows rows (see Skin widgets). This edits one of the skin's files (Includes_Search.xml). A skin update replaces that file, so Seerr Hub checks it when Kodi starts and every 10 minutes, and puts the change back. If the update deleted the skin's generated menus, it also asks SkinVariables to rebuild them. The skin reloads only while you're on the home screen with nothing playing. If a skin update changes that file in a way Seerr Hub doesn't recognise, it leaves the file alone and notes it in the Kodi log. Turning the setting off puts the skin's own version back.
Seerr Hub uses JustWatch data to see which services have a title in your region. On Android it opens the official app straight to that title, if the app is installed.
| Region | Apps |
|---|---|
| Worldwide | Netflix, Prime Video, Disney+, HBO Max, Apple TV+, Paramount+, YouTube, Crunchyroll, MUBI |
| US / Canada | Hulu, Peacock, Tubi, Pluto TV, Crave |
| UK | BBC iPlayer, ITVX |
| Australia | Stan, Binge, Kayo, ABC iview, SBS On Demand, 9Now, 7plus, 10 Play |
Services that aren't in this list, or whose app isn't installed, are still named in the menu title, e.g. "also on Paramount+".
Adding an app takes one line in resources/lib/api.py (SERVICES): the JustWatch name, the display name, the Android package name, and whether to open the web link or the app link. Pull requests welcome.
The "Open in Netflix" (etc.) option doesn't show up
- Only Android can open other apps. On Windows, Linux and macOS the service is named in the title instead.
- The app has to be installed, and the title has to be on that service in your region. Check the Streaming region setting, or the region in Seerr.
"In Plex - not in Kodi's library yet"
Seerr knows the title is on your server, but PlexKodiConnect / Jellyfin for Kodi hasn't synced it into Kodi yet. Wait for the next sync, or start one from that add-on.
"Kodi can't see the downloads folder yet" / downloads won't play
Set Download folder as Kodi sees it to the torrent client's default download folder (qBittorrent: default save path; Transmission: download directory; Deluge: download to), as a share Kodi can open. Test it first in Kodi's file manager. For example, the client saves to /data/downloads and the NAS shares that folder as smb://nas/downloads/.
"... wants a login" / "refused the login"
- qBittorrent: fill in the user name and password, or allow your network: Options → Web UI → Bypass authentication for clients in whitelisted IP subnets.
- Transmission: fill in the RPC user name and password. If it still refuses, add Kodi's address to
rpc-whitelistin Transmission'ssettings.json(or turn the whitelist off), with Transmission stopped. - Deluge: put the Web UI password in Password. The Web UI must be connected to a daemon. Seerr Hub connects it to the first one in the Web UI's Connection Manager if it isn't.
Transmission: "as fast as it can" instead of "in order"
Downloading in order needs Transmission 4.1 or newer. Older versions still work, but the start of the file arrives in random order, so Watch now comes later, often near the end.
Watched status isn't copied to Jellyfin
Check that Jellyfin for Kodi is signed in, or fill in the Jellyfin settings. Seerr Hub needs a user to update. If you use an API key with several users on the server, set User name.
Where are the logs?
In Kodi's log (kodi.log). Every line from this add-on starts with [seerrhub], and watched-status sync lines start with [seerrhub] sync:.
Seerr Hub only talks to:
- your own servers: Seerr, and if you set them up, Plex / Jellyfin / Emby, Radarr / Sonarr (through Seerr's settings) and your torrent client
- JustWatch's public API, to look up where a title streams (title name + region only)
- TMDb's image server, for posters
There's no account, no tracking and no analytics. API keys stay in Kodi's settings on your device.
git clone https://github.com/Mooseca/plugin.video.seerrhub
cd plugin.video.seerrhub
python3 build.py # -> plugin.video.seerrhub-<version>.zipReleases go out as a GitHub release and through the Mooseca repository (python3 build.py <zip> there, then push).
The add-on is plain Python with no extra dependencies:
| File | What's in it |
|---|---|
default.py |
Menus and lists (Search, Trending, Recommended, My requests, Downloading) |
context.py |
The "Watch or request" context-menu item |
service.py |
Background service: watched-status sync, the Downloading widget refresh and the optional skin tweaks |
resources/lib/skinpatch.py |
The optional Arctic Fuse 3 search tweaks, re-applied after skin updates |
resources/lib/hub.py |
The title menu, release picker and watch-while-downloading |
resources/lib/api.py |
Seerr, JustWatch, Radarr/Sonarr, qBittorrent / Transmission / Deluge clients, and release ranking |
resources/lib/mediasync.py |
Watched / resume-point sync to Plex, Jellyfin and Emby |
Bug reports and pull requests are welcome, especially from Emby users and from regions whose streaming apps aren't mapped yet.
Built on the work of Seerr / Overseerr / Jellyseerr, PlexKodiConnect, Jellyfin for Kodi, TMDb Helper, and the streaming data from JustWatch. Not affiliated with any of them, or with any streaming service.






