OMDb Enrichment

OMDb Enrichment

bitmagnet can enrich movies and TV shows with additional metadata from the OMDb API — Rotten Tomatoes scores, Metacritic ratings, awards, box office data, and detailed plot summaries.

OMDb runs automatically after TMDB classification for any torrent with an IMDB ID. It works on both DHT-sourced and Prowlarr-sourced torrents.

---

Setup

1. Get a free API key at omdbapi.com/apikey.aspx
2. Add to config.yml:

omdb:
  enabled: true
  api_key: your_omdb_key_here

Or via environment variables:

environment:
  - OMDB_ENABLED=true
  - OMDB_APIKEY=your_omdb_key_here

No additional worker key is needed — OMDb runs inline in the classifier pipeline.

---

What OMDb adds

All data is stored as ContentAttribute rows with source="omdb":

• MPAA / TV content rating (Rated)
• Runtime, Genre, Director, Writer, Actors
• Plot summary, Language, Country, Awards
• Poster URL
• Metascore, IMDB rating, IMDB votes
• Box office gross
• Individual ratings: Rotten Tomatoes, Metacritic, IMDB (as rating_<source>)

---

Rate limits

Tier	Limit
Free	1,000 requests/day
$1/month Patreon	100,000 requests/day

The default rate limit (3 second interval) produces ~1,200 requests/hour, well within daily limits for normal use. The rate limit is configurable:

omdb:
  rate_limit: 3s
  rate_limit_burst: 1

---

Behavior

• OMDb only fires for content that has an IMDB ID (set by TMDB classification)
• If OMDb fails for any reason, the torrent keeps its TMDB classification — OMDb is non-fatal
• The classifier flag omdb_enabled controls whether OMDb runs (default: true when config is set)
• Automatically disabled when omdb.enabled is false or omdb.api_key is empty