Guide

Features & config

TPB 4K Porn is a self-hosted Stremio addon for 4K and 1080p adult torrent catalogs with optional debrid and metadata. This page covers every feature and how to turn it on in the configure page.

Content sources

Turn sources on in the Active Sources card. Each enabled source adds its own catalogs to Stremio Discover.

  • TPB / HiddenBay: 4K and 1080p adult releases with JAV title and studio search. Extra indexers (Knaben, XxxClub) and 1337x search add coverage at the cost of cache hit rate.
  • PornRips: scene release catalogs with studio filters and optional TPDB and StashDB metadata for posters, cast, and tags.
  • Hentai: hentai series streamed as direct video episodes.
  • Sukebei (beta): Sukebei Nyaa JAV torrents with top and recent sorts, cross-referenced with StashDB metadata.
  • Stripchat (beta): four live cam catalogs (Girls, Couples, Guys, Trans) with username search and multi-quality HLS via a dedicated proxy.
  • ThePornDB: a scene browser with optional TPDB and StashDB category catalogs.

Catalogs and sorts

TPB catalogs come in two sorts: recent and top, each split into 4K and 1080pquality scopes. Toggle which sorts and qualities appear in the Catalogs tab of the configure page. Studio presets add curated per-studio catalogs (for example ATKGirlfriends, ATKExotics) so you can browse one studio's 4K and 1080p releases directly.

Debrid providers

Add a key for any service you use in the Debrid Providers card. That provider handles your streams. Leave all blank for P2P-only. The 13 supported providers, in priority order:

  1. Real-Debrid
  2. AllDebrid (client-side, see below)
  3. TorBox
  4. Premiumize
  5. EasyDebrid
  6. Debrid-Link
  7. Offcloud
  8. Put.io
  9. Deepbrid
  10. LinkSnappy
  11. Mega-Debrid
  12. Debrider
  13. Seedr

You can configure multiple providers at once. The stream router fans out across all of them, so the same torrent shows a stream per provider. Real-Debrid and TorBox forward your public IP so their CDN links are bound to your location; the others resolve server-side.

Pre-cache toggle

The Pre-cache debrid links on click toggle (in the Debrid Providers card) controls how uncached torrents are handled:

  • Off (default, Nuvio-style): opening an entry does not add the torrent. A read-only probe labels cached links [RD+] and uncached links [RD] (Real-Debrid and TorBox only). The torrent is added only when you click play, and a short caching clip plays if it is still downloading.
  • On (legacy): uncached torrents are warmed in the background after a click, so the next click is instant. Labels are plain [RD].

AllDebrid ignores this setting. It has no pre-cache and always resolves on play through the redirector.

Remove-from-debrid links

In pre-cache-off mode, turn on Show remove-from-debrid links to add a second, selectable stream entry per torrent for providers that expose a delete-by-hash API (Real-Debrid, TorBox, Premiumize, Debrid-Link, Put.io, Seedr). Clicking it best-effort deletes the torrent from your debrid account and plays a short removed clip, so a misclick or a stuck cache can be cleaned up. The remove entry sorts to the bottom of the stream list.

AllDebrid redirector

AllDebrid blocks the addon server's datacenter IP and has no IP forwarding, so it resolves through a small local redirector on your own machine. When you set an AllDebrid API key, an AllDebrid redirector URL field appears; point it at your redirector (for example http://localhost:8282). The Stremio player fetches that URL from your residential IP, and the redirector runs the full AllDebrid flow and hands back the CDN link. Full steps: AllDebrid redirector guide.

MediaFlow proxy

Route debrid stream URLs through your own MediaFlow Proxy instance to bypass IP-locked CDN links or ISP and region blocks. Turn it on in the MediaFlow Proxy card and set the proxy URL and API password. AllDebrid streams are exempt; they go through the redirector above. Full steps: MediaFlow Proxy guide.

TPDB and StashDB metadata

Two independent metadata sources, merged per field. In the ThePornDB & StashDB card, add an API token for either or both. Metadata enrichment (cast, tags, studio, posters) turns on automatically once a token is saved. The catalog toggles add TPDB and StashDB category tabs to Discover. StashDB also powers the Sukebei JAV catalog. A server-side key may already have either source enabled by the operator, in which case the toggle is available without pasting your own token.

Encrypted presets and accounts

The configure page can save your settings as an encrypted preset tied to an account, so you can install the same configuration on another device (desktop, mobile, TV) without re-entering tokens. Use the Account button in the header to save and load presets. The install URL itself also carries your full config, so a saved link is enough to replicate a setup.

P2P fallback

With no debrid key configured, every stream is a direct magnet that plays in a torrent-capable player. When a debrid key is set, P2P appears only when no provider produced a debrid stream for that torrent, unless you turn on Hide P2P fallback links to suppress magnet streams entirely while a debrid key is active.

More questions

Can I use more than one debrid provider at the same time?
Yes. Add a key for every provider you use in the configure page. The stream router fans out across all of them per request, so each provider shows up as a separate stream for the same torrent. This is useful for comparing cache availability across providers.
Should I turn pre-cache on or off?
Off (the default) is the Nuvio-style behavior: cached links show as [RD+] and uncached as [RD], and the torrent is added to your debrid account only when you click play. Turn it on for the legacy behavior where uncached torrents are warmed in the background so the next click is instant. AllDebrid ignores this setting; it always resolves on play through the redirector.
What metadata do I get without TPDB or StashDB?
TPB and PornRips catalogs still work with posters and titles from the source sites. TPDB and StashDB add richer scene metadata: cast, tags, studio, and higher-quality posters. StashDB also powers the Sukebei JAV catalog. Both are free and independent; configure either or both.
Do I need a debrid account at all?
No. With no debrid key configured, the addon returns P2P magnet streams that play in a torrent-capable player. Debrid gives you instant cached CDN streams and avoids relying on seeders.