Files
MediaManager-maxdorninger/Writerside/topics/metadata-provider-configuration.md
2025-08-23 17:54:57 +02:00

2.7 KiB

Metadata Provider Configuration

Metadata provider settings are configured in the [metadata] section of your config.toml file. These settings control how MediaManager retrieves information about movies and TV shows.

TMDB Settings ([metadata.tmdb])

TMDB (The Movie Database) is the primary metadata provider for MediaManager. It provides detailed information about movies and TV shows.

Other software like Jellyfin use TMDB as well, so there won't be any metadata discrepancies.

tmdb_relay_url

If you want to use your own TMDB relay service, set this to the URL of your own MetadataRelay. Otherwise, use the default relay.

  • Default: https://metadata-relay.dorninger.co/tmdb
  • Example: https://your-own-relay.example.com/tmdb

TVDB Settings ([metadata.tvdb])

The TVDB might provide false metadata and doesn't support some features of MediaManager like showing overviews. Therefore, TMDB is the preferred metadata provider.

tvdb_relay_url

If you want to use your own TVDB relay service, set this to the URL of your own MetadataRelay. Otherwise, use the default relay.

  • Default: https://metadata-relay.dorninger.co/tvdb
  • Example: https://your-own-relay.example.com/tvdb

MetadataRelay

To use MediaManager you don't need to set up your own MetadataRelay, as the default relay hosted by the developer should be sufficient for most purposes.

The MetadataRelay is a service that provides metadata for MediaManager. It acts as a proxy for TMDB and TVDB, allowing you to use your own API keys if needed, but the default relay means you don't need to create accounts for API keys yourself.

You might want to use your own relay if you want to avoid rate limits, protect your privacy, or for other reasons. If you know Sonarr's Skyhook, this is similar to that.

Where to get API keys

If you want to use your own MetadataRelay, you can set the tmdb_relay_url and/or tvdb_relay_url to your own relay service.

Example Configuration

Here's a complete example of the metadata section in your config.toml:

[metadata]
    # TMDB configuration
    [metadata.tmdb]
    tmdb_relay_url = "https://metadata-relay.dorninger.co/tmdb"

    # TVDB configuration  
    [metadata.tvdb]
    tvdb_relay_url = "https://metadata-relay.dorninger.co/tvdb"
In most cases, you can simply use the default values and don't need to specify these settings in your config file at all.