Skip to content

ThePornDB Classification

Jump to bottom
Michael edited this page Jul 17, 2026 · 1 revision

ThePornDB Classification

TMDB does not cover adult content, so XXX torrents normally stay unclassified. This fork adds a ThePornDB (TPDB) classifier that matches and titles adult content, running in the same classifier pipeline as TMDB and OMDb.

It is disabled by default and requires an API key.

Setup

  1. Get an API token from theporndb.net (account required).
  2. Add to config.yml:
tpdb:
  enabled: true
  api_key: your_tpdb_token_here

Or via environment variables:

environment:
  - TPDB_ENABLED=true
  - TPDB_APIKEY=your_tpdb_token_here

No separate worker key is needed -- TPDB runs inline in the classifier pipeline, like OMDb.

Configuration

tpdb:
  enabled: true
  api_key: your_tpdb_token_here
  base_url: https://api.theporndb.net   # default
  rate_limit: 1s                        # default 1 req/sec (API allows 2/sec)
  rate_limit_burst: 1

Behavior

  • Fires for torrents classified as adult content.
  • Non-fatal: if a lookup fails, the torrent keeps whatever classification it already had.
  • Conservative default rate limit (1 request/second) to stay within API limits.
  • Disabled automatically when tpdb.enabled is false or tpdb.api_key is empty.

See Content Classification for how the classifier pipeline fits together.

Clone this wiki locally