cli_debrid
cli_debrid is a successor to, and pays homage to, plex_debrid. It watches your lists, finds the best release for everything on them, gets it through your debrid service or Usenet, and keeps your Plex or Jellyfin library organised and upgraded, with no files downloaded to your server.
It works with Real-Debrid, AllDebrid, TorBox, Premiumize and Debrid-Link, and with Usenet (NZB) through cli_mount, NzbDAV or Zurg, for Plex, Jellyfin and Emby.
📖 Getting Started · Documentation · Discord
How can you support the project?
cli_debrid will always be free.
Version Information
Main Branch
Dev Branch
Community
- Discord: join to ask questions or share ideas.
Screenshots
Dashboard: library totals, what's airing, and what was just added or upgraded.
Discover: browse trending titles, recommendations and lists, and request them in one click.
Database: every movie and episode cli_debrid tracks, with filters, saved presets and bulk actions.
Queues: what's wanted, unreleased, collected or blacklisted.
How it works
Content sources ──> Scrapers ──> Debrid / Usenet ──> Mount ──> Library ──> Plex / Jellyfin / Emby
(what you want) (find it) (get it) (stream) (organise) (watch)
- Content sources say what you want: watchlists, lists, requests.
- Scrapers search torrent indexers and Usenet indexers. Results are ranked against your Versions, the quality profiles you define (resolution, size, codecs, languages, preferred groups).
- The best cached release goes to your debrid service or your Usenet provider.
- A mount (cli_mount, Decypharr or Zurg + rclone) streams the files from the cloud. Nothing is downloaded to your server.
- cli_debrid files them into your library, as Plex-tracked items or a symlinked folder tree, tells your media server to scan, and keeps looking for upgrades.
Coming from another setup?
- plex_debrid: cli_debrid is its successor. It does the same job (watchlists in, cached releases out, Plex library kept up to date) with a web interface, a local database of what you have, and automatic upgrades and repairs.
- Sonarr/Radarr with a debrid downloader: cli_debrid takes the place of the *arr apps and the download client. It scrapes, ranks releases against your Versions, sends them to your debrid service or Usenet provider, and builds the library. Bazarr can still connect to it as if it were Sonarr/Radarr.
- Usenet with SABnzbd or NZBGet: NZBs are streamed from your news server through the mount, with nothing downloaded first. See the cli_mount setup guide.
Key Features
Getting content
- Debrid providers: Real-Debrid, AllDebrid, Premiumize, TorBox and Debrid-Link.
- Usenet: NZBs from your Newznab indexers, streamed through cli_mount, NzbDAV or Zurg, with no download step. Usenet can be used alone or next to a debrid service.
- Scrapers: Torrentio, Jackett, Prowlarr, Zilean, Nyaa, MediaFusion, AIOStreams and Newznab, with SeaDex for best-release anime picks.
- Content sources: MDBList, Trakt (watchlists, lists, collection, friends), Plex (your watchlist, other users' and friends' watchlists, RSS), Seerr/Overseerr, Agregarr, Scrob, Adaptive Lists and your existing collection.
- Manual and magnet assign: paste a magnet, torrent or NZB, then map the files to episodes yourself or let the matcher do it. It understands season packs, absolute-numbered anime packs and multi-episode files, and can replace episodes already in your library.
Keeping it healthy
- Upgrading: collected items keep getting checked for better releases within your upgrade window.
- Repair: broken or incomplete files (dead torrents, missing Usenet articles) are detected and replaced automatically.
- Blacklisting and not-wanted lists: bad releases aren't picked again.
- Sync deletions: removing something from your media server or a source can remove it from cli_debrid too.
Anime and TV
- Absolute numbering: packs like
Show - 152.mkv or S01E152 are matched to the right season and episode.
- Episode orders: each show can follow TVDB aired, DVD or absolute order, or any TMDB episode group. Collected files are renamed to match, and Plex's ordering is kept in sync.
- Per-show anime setting, romaji and alternative-title searching, and seasons that are really movies (e.g. Initial D Third Stage).
Library and media servers
- Plex or symlinked library: Plex mode tracks your library through Plex's API. Symlinked mode builds a clean folder tree from your mount, with naming templates, for Plex, Jellyfin or Emby.
- Plex extras: collections, smart collections, labels, movie box sets and poster overlays.
- Subtitles: built-in subtitle downloading, or let Bazarr connect to cli_debrid as if it were Radarr/Sonarr.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
