Gelato

[!NOTE] Looking for the next evolution of Gelato? Check out Remux, a media server written in Rust that replaces Jellyfin instead of plugging into it. It supports local libraries, remote sources, and Stremio addons, and it works with your Jellyfin clients.

Gelato brings your AIOStreams addon into Jellyfin. Jellyfin's search also finds what the addon offers, and the catalogs you pick are imported into your library on a schedule. Their titles behave like your own media: you browse, search, and play them in any Jellyfin client.

Features

• Search: Jellyfin's search also finds titles from the addon, ready to play.
• Catalogs: import the addon's catalogs into your library, kept up to date by a scheduled task.
• Streams on demand: Gelato finds the streams when you press play. Nothing is downloaded.
• Like your own media: the titles are regular Jellyfin library items.
• Proxy: streams go through Jellyfin, so your debrid service sees a single IP.
• Per-user settings: a user can have their own addon, for example for a kids' account.
• Seerr requests: a request approved in Seerr (Jellyseerr, Overseerr) adds the title to your library.

Usage

1. Set up AIOStreams. Host it yourself or use a public instance, for example the ElfHosted public instance.

   New to debrid? Sign up with one of my referrals.

   You need at least the TMDB addon turned on for search, and one addon that finds streams (Comet, for example). Or import the starter config, then turn on your debrid providers under Services.

2. On Jellyfin 12, add https://raw.githubusercontent.com/lostb1t/Gelato/refs/heads/gh-pages/repository.json to your plugin repositories.

   Upgrading from Jellyfin 10.11? First update Gelato to its final 10.11 release, and shut the server down normally at least once before you upgrade Jellyfin. That release empties the Gelato folders on shutdown; without it, the first Jellyfin 12 start deletes every Gelato title. Its settings page shows whether your server is ready. If you upgraded without it, Gelato runs the Repair watch state task once on the first start and brings back every title that still has watch state (see the FAQ).

3. Install the plugin and open its settings. The Setup assistant walks you through the addon, the libraries, and the catalogs. Gelato supports only AIOStreams.

   To change the libraries later, use Default movies library and Default series library on the Libraries tab. Pick a library you have and save, and Gelato adds a folder of its own to it. Or pick New library: Gelato creates the folder, and Copy folder gives you its path for Jellyfin's library dialog.

4. In Jellyfin, check each library's settings: Gelato should be first under the metadata downloaders and image fetchers. Gelato doesn't change the settings of a library you had before, so turn it on there yourself.

5. Search for a movie and play it. Or run the Import Catalogs task to fill your library.

For a step-by-step guide, see the setup guide.

Seerr requests

Gelato adds titles requested in Seerr (Jellyseerr, Overseerr). The Gelato settings show the fields below on the Libraries tab, each with a Copy button. In Seerr, go to Settings > Notifications > Webhook:

• Webhook URL: http://<your-jellyfin>:8096/gelato/seerr
• Authorization Header: MediaBrowser Token="<API key>", with a key from Jellyfin's Dashboard > API Keys
• JSON Payload: leave the default
• Notification Types: Request Approved and Request Automatically Approved

An approved request adds the movie or series to your library, and Seerr marks it available at its next Jellyfin scan. If the requester has libraries of their own on Gelato's Users tab, the title goes there. A series request adds the whole series, also when it named only some seasons.

Notes

• Gelato supports only AIOStreams.

RemuxDB

Gelato uses RemuxDB, a shared database of stream media info (audio, subtitles, quality, runtime), so a title shows its info before you play it and playback skips its probe. This is on by default.

• Look up: Gelato sends RemuxDB the title's IMDb id (plus season and episode for an episode) and a random id for your install. That id is tied to nothing else.
• Contribute: only when RemuxDB has no data for a stream you played yet, and only for a stream whose torrent is known, Gelato sends the torrent's infohash, the file name and size, the title's IMDb, TMDB, and TVDB ids, and the media info it probed. No links, accounts, or personal data.
• Turn it off: clear Look up media info on RemuxDB and Contribute to RemuxDB on the Playback tab, or in the setup assistant. The two are independent: turning off lookups doesn't stop contributions, so clear both to stop all contact with RemuxDB.

This is the beginning of the README. Read the rest at the original. Read the full README ↗