No description
  • Go 98.3%
  • Makefile 1.4%
  • Dockerfile 0.3%
Find a file
zemdregon 73bf63d1e3
Some checks are pending
CI / lint (push) Waiting to run
CI / test (push) Waiting to run
CI / build (push) Waiting to run
CI / docker (push) Blocked by required conditions
chore: fold remaining local workspace changes
2026-08-17 09:35:23 -05:00
.github/workflows chore(deps): bump docker/setup-buildx-action to v4 2026-08-10 18:17:28 -05:00
cmd/module feat: settings support plus CI/LICENSE bootstrap 2026-07-22 19:09:49 -05:00
internal chore: fold remaining local workspace changes 2026-08-17 09:35:23 -05:00
proto/metadatav1 feat: HTTP cache, in-flight dedupe, and rate limiting 2026-07-21 20:20:06 -05:00
.env.example fix: change default gRPC port to avoid collision with auth-oidc 2026-08-07 10:46:20 -05:00
.gitignore Initial commit 2026-07-03 12:03:11 -05:00
.golangci.yml Initial commit 2026-07-03 12:03:11 -05:00
CHANGELOG.md Sync module version metadata to 0.1.5. (#12) 2026-08-10 00:27:36 -05:00
COMPATIBILITY.md docs: add CHANGELOG and COMPATIBILITY (#8) 2026-08-09 19:58:29 -05:00
Dockerfile Initial commit 2026-07-03 12:03:11 -05:00
go.mod refactor: wire settings via sdk RegisterSettings (#10) 2026-08-09 23:19:55 -05:00
go.sum refactor: wire settings via sdk RegisterSettings (#10) 2026-08-09 23:19:55 -05:00
LICENSE feat: settings support plus CI/LICENSE bootstrap 2026-07-22 19:09:49 -05:00
Makefile Initial commit 2026-07-03 12:03:11 -05:00
muxcore.json Sync module version metadata to 0.1.5. (#12) 2026-08-10 00:27:36 -05:00
README.md fix: change default gRPC port to avoid collision with auth-oidc 2026-08-07 10:46:20 -05:00

Metadata TMDB

TMDB (The Movie Database) metadata provider for movies and TV shows.

Key Features

  • Search movies/TV (title query; optional year/language/page)
  • Movie and TV details (title, overview, dates, runtime, genres, companies, etc.)
  • Season details with episode list
  • Movie collections
  • Find by external ID (default source imdb_id)
  • Alternative titles
  • Trending and popular lists
  • Image configuration (poster/backdrop sizes, base URLs)
  • In-process response cache, request coalescing, and outbound rate limiting
  • Runtime settings mesh (api_key, base_url)
  • Configurable API base URL (HTTP client timeout defaults to 15s)

Configuration

Env Var Default Description
TMDB_API_KEY "" TMDB API key
MUXCORE_CFG_TMDB_API_KEY "" Alternative TMDB API key
METADATA_GRPC_ADDR :9411 gRPC listen address
TMDB_BASE_URL https://api.themoviedb.org TMDB API base URL
TMDB_CACHE_MAX 1024 Max cached responses (0 disables)
TMDB_CACHE_TTL_DETAILS 6h TTL for movie/TV/collection details
TMDB_CACHE_TTL_SEARCH 15m TTL for search/find
TMDB_CACHE_TTL_LIST 1h TTL for trending/popular
TMDB_RATE 35 Outbound requests per second (0 = unlimited)
TMDB_BURST 40 Token-bucket burst size
MUXCORE_INSECURE_DISABLE_TLS unset Set true for insecure gRPC to core (dev)

Capability

metadata, metadata.tmdb, settings — TMDB metadata provider with runtime settings

Dependencies

  • github.com/Muxcore-Media/core — MuxCore SDK