TPB 4K Porn

Self-hosted adult Stremio addon

4K & 1080p adult torrent catalogs from multiple trackers. Optional scene metadata from TPDB and StashDB. Stream resolution via 12 debrid providers including Real-Debrid and TorBox - or fall back to P2P.

View on GitHub Read the Docs
Join Discord Support on Ko-fi Stremio adult addons
Open-source · GPL-3.0 · Self-hosted

What it is

A Node.js Express server that speaks the Stremio addon protocol. Deploy it on any Docker host or VPS, open the configure page, and install the generated addon URLs into Stremio. Your debrid API keys never touch the server - they live only in your personal install URL.

Catalog

Browse adult content by category (XXX, Trans, Gay, Lesbian, JAV) or studio, in Top and Recent sort orders, across 4K and 1080p quality tiers.

Metadata

Scene titles, performer names, cover images, and descriptions sourced from TPDB and StashDB. A community-shared cache means the whole user base benefits from a single lookup.

Stream

Resolves magnets through your debrid provider into instant CDN links. Per-file stream entries for multi-file packs. P2P fallback when debrid misses.

Key features

12 Debrid Providers

Real-Debrid, TorBox, Premiumize, EasyDebrid, Debrid-Link, Offcloud, Put.io, Deepbrid, LinkSnappy, Mega-Debrid, Debrider, Seedr.

Multiple Content Sources

HiddenBay 4K/1080p, TorrentGalaxy, MagnetDL, LimeTorrents, PornRips scene releases, PornTube (via TPDB), and Hentai episodes.

TPDB + StashDB Metadata

Enriches torrent items with scene titles, performers, cover art, and descriptions. A 30-day shared Redis cache benefits every user from a single lookup.

Keys Never Leave Your Browser

Debrid API keys are encoded in your personal install URL (base64url JSON), never stored on the server or logged.

Tabbed Configure UI

Dark configure page with tabs for Tokens, Streams, Catalogs, and Display. Searchable studio picker, quality toggles, per-provider install URLs.

Redis Caching

Catalog lists, cover images, debrid links, and metadata cached in Redis. Degrades gracefully to no-ops when Redis is absent - nothing breaks.

How it works

From deploy to playing in Stremio - five steps.

  1. 1

    Deploy the server

    Run the Docker container on any VPS, home server, or container host. Set BACKEND_URL and optionally REDIS_URL + metadata API keys.

  2. 2

    Open /configure

    Browse to https://your-host/configure. Enter your debrid API key(s), TPDB/StashDB tokens, and choose which catalogs to enable.

  3. 3

    Generate install URLs

    Click Generate Install URLs. The form builds one or more stremio://… URLs, each carrying your config in a base64url segment.

  4. 4

    Install in Stremio

    Click Install in Stremio for each generated addon. Stremio fetches the manifest, discovers the catalogs, and shows them in your sidebar under the addon name.

  5. 5

    Browse and play

    Stremio calls catalog/meta/stream endpoints. The addon resolves magnets through your debrid provider and returns instant CDN URLs - or P2P streams as fallback.

Configuration highlights

Key environment variables for operators. Full reference in docs/configuration.md.

Variable Required Description
BACKEND_URL Yes* External torrent-search backend API base URL
REDIS_URL No Redis connection URL - enables caching and background enrichment
TPDB_API_KEY No ThePornDB API key for server-side metadata enrichment
STASHDB_API_KEY No StashDB GraphQL API key (merged with TPDB per field)
ADULT_SOURCE No Torrent source: piratebay (default) or all for multi-source
PORT No Listen port (default 7000)

Quickstart

Docker is the recommended deployment method.

bash 
# Clone and build
git clone https://github.com/akshatsinghkaushik/stremio-tpb-porn.git
cd stremio-tpb-porn
docker build -t stremio-tpb-porn .

# Run (set your own BACKEND_URL)
docker run -p 7000:7000 \
  -e BACKEND_URL=https://your-backend.example.com \
  -e REDIS_URL=redis://your-redis:6379 \
  stremio-tpb-porn

# Open the configure page
open http://localhost:7000/configure

See docs/development.md for local development, Node --watch mode, and the full project layout.

FAQ

Do I need a debrid account?
No. Without a debrid account the addon returns P2P magnet streams that Stremio plays via its built-in torrent client. A debrid account (Real-Debrid, TorBox, etc.) adds instant CDN streams that are much faster and more reliable.
Where are my API keys stored?
Nowhere on the server. Keys are encoded in your personal install URL as base64url JSON and are never logged or persisted server-side. Each Stremio request includes the key in the URL segment decoded at request time.
What is the multi-instance split?
Stremio has a manifest size limit. The full catalog set (dozens of studios × 2 sort orders × 2 quality tiers) would exceed it. The addon automatically splits large installs into multiple addon instances, each with ≤30 catalog bases. Each gets a unique manifest ID so they coexist in the sidebar.
What is TPDB and do I need an API key?
TPDB (ThePornDB) is an adult scene metadata database. It enriches catalog items with clean titles, performer names, cover art, and descriptions. The key is optional - without it you still get raw catalog results and cover images from torrent pages. Once any user with a key matches a torrent, the metadata is cached and shared with everyone (30-day TTL).
Is the source code open?
Yes. The code lives at github.com/akshatsinghkaushik/stremio-tpb-porn under the GNU GPL v3 licence. Issues, pull requests, and discussion are welcome.