Integrations
🌐 English · Deutsch
All integrations are configured on the Integrations page (/integrations).
After successful downloads the app automatically triggers a library refresh on your media server so new episodes show up immediately.
- Enter server URL and API key (create the key in Jellyfin under Administration → API Keys).
- The test button verifies the connection and shows the server name.
- Enter the Plex URL; sign-in happens conveniently via Plex OAuth (PIN flow) straight from the UI — the token is stored automatically.
- Optionally select a specific library section (otherwise all are refreshed).
- The UI can additionally show whether the server is currently scanning.
MediaScan loads your media server's complete library (series + movies with TMDB/IMDB/TVDB IDs) into a local cache. The UI can then mark, while browsing, what's already in your collection.
- Source: Jellyfin (own URL + API key) or Plex (own URL; the Plex token is shared with the media player integration — one OAuth sign-in is enough).
- Refresh: automatically every 24 h, about 2 minutes after every successful download (so the server can ingest the file first), and manually via button.
- Missing TMDB IDs are resolved locally from IMDB IDs via the CineInfo cache where possible (relevant for Plex anime with legacy agents).
- Store the Seerr URL and API key.
- The Seerr requests page (
/seerr) shows pending and approved-but-not-yet-available requests (series + movies) with posters, description and requested seasons. - Requests can be approved, declined or hidden directly — and of course started as downloads right away.
With a (free) TMDB API key the app enriches browse and search views with metadata:
| Option | Description |
|---|---|
| Country | Region for streaming providers & age rating (default DE) |
| Show streaming providers | Where is the title legally available? |
| Genres, age rating, rating | Badges on the cards |
| Recommendations | "You might also like" on detail pages |
| Trailer | Embed YouTube trailers |
| Hover info | Rating/genres/age rating on card hover |
| Advanced search | Enables the /advanced-search page |
| Calendar | Enables the /calendar page, with sub-options for Seerr requests, Media Library series and the refresh interval |
TMDB responses are cached locally for 24 h (with automatic cleanup); the cache can be cleared from the UI.
Title localisation: In the detail dialog the series title is only replaced with the TMDB title when the match is clearly correct (a similarity check against the original and localised titles). For uncertain matches the source's original title is kept — so a spin-off, for example, won't override the real series title.
TMDB Discover with filters for genres, keywords (with autocomplete based on the daily TMDB keyword export), streaming providers and region — results can be searched and downloaded on the streaming sites directly.
Shows upcoming episode air dates and movie releases for your AutoSync jobs, Seerr requests and Media Library series. Enabled here and configured with sub-options for the overlay sources and the refresh interval. A background watcher caches the schedule data — see Calendar for the full description.
An optional Crunchyroll login (sub-section of CineInfo) adds two things that pure TMDB data can't always provide:
- Provider pill for current simulcasts. When a title is available on Crunchyroll, a Crunchyroll pill is shown in the detail dialog — even for brand-new simulcasts that TMDB's provider list hasn't picked up yet. The availability answer is cached for 24 h.
- Calendar sync. Crunchyroll release dates can be added to the Calendar as their own source.
| Option | Description |
|---|---|
| Enable Crunchyroll integration | Master switch for all Crunchyroll features |
| Email / Password / Language | Account login. The password is stored encrypted at rest (Fernet, like the other secrets). The session token is cached in an encrypted file so you don't log in on every request. |
| Profile | Pick which account profile the watchlist is read from (loaded via Test connection). |
| Anonymous mode | Public metadata only, no account — provider pills work, watchlist sync does not |
| Crunchyroll provider pill | Toggles the extra pill described above |
| ↳ Sync Crunchyroll simulcast calendar | Adds the current + next simulcast season lineup to the Calendar. The titles come from the Crunchyroll API (up to ~80 series, cached 30 min); the actual air dates are resolved via TMDB, reusing the same calendar cache as AutoSync/Seerr |
| ↳ Sync with my watchlist/list | Highlights calendar entries that are on your Crunchyroll watchlist; with the simulcast sync off, only your watchlist releases are shown. Requires an account. |
Use Test connection to validate the credentials; for an account login it reports the active profile and whether premium features are available.
The integration uses a vendored single-file build of the crunchyroll-api library (
src/mediaforge/vendor/crunchyroll_api.py). Video streams are DRM-protected and are not downloaded — only metadata, availability and schedule data are used.
Privacy / ToS note: this logs in to your personal Crunchyroll account. Credentials never leave your server. Heavy automated use may be subject to Crunchyroll's terms of service.
The DNS integration (Cloudflare/Google/Quad9/custom DoH) is described under Configuration.