Kometa

Kometa is a powerful tool designed to give you complete control over your media libraries. With Kometa, you can take your customization to the next level, with granular control over metadata, collections, overlays, and much more.

Transform your media library with Kometa and discover its full potential! Connect to third-party services like TMDb, Trakt, and IMDb, among others, to create one-of-a-kind collections, overlays and more. Your media library will stand out and be tailored to your specific needs.

Setting up

kometa_enabled: true

Configuration

After first run, Kometa will create a default configuration in the config directory. You will need to configure this manually before Kometa will function properly. At a minumum, you will need to set a TMDb API key (free), and Plex URL and Token.

Follow these instructions to configure Kometa: https://kometa.wiki/en/latest/kometa/install/walkthroughs/docker/#setting-up-the-initial-config-file.

See the default configuration options for Kometa at roles/kometa/defaults/main.yml. Add any overrides to your inventories/[your_inventory]/group_vars/homelab.yml file.

Recent Changes

Nov 15, 2025

Fix Use the user's timezone instead of UTC

Nov 14, 2025

Fix Fix warning for missing assets folder even if assets aren't used

Nov 10, 2025

Fix Env list to dict

Fix Fix directories not creating

Oct 31, 2025

Feat Add Kometa