Kometa v2.5.4 drops Python 3.10, adds music builders and Seerr connector

Kometa, the metadata and collection manager many self-hosters run against a Plex library, shipped v2.5.4 on October 31, 2026. The release touches documentation, runtime requirements and a broad set of new builders and connectors.

What changed

On the documentation side, the project replaced its MkDocs wiki with Zensical while keeping Read the Docs hosting, branch versions and the existing documentation URLs. Release Notes are now part of the Kometa website, listed under the Useful Links section of the navigation.

The most consequential change for operators is the removal of Python 3.10 support, since it has reached end of life. Python 3.11 or above is now required, so anyone running Kometa in a container based on an older interpreter, or in a virtualenv they set up years ago, should check their version before upgrading.

New functionality includes:

• list_export for exporting builder results to MDBList, FlickList, WeTrakr, TMDb or Floppy lists, with sync or append mode. The legacy sync_to_*_list attributes are dropped from the documentation.
• dovi_level and dovi_profile filters for plex_all builders, plus hdr10plus and atmos boolean attributes for plex_search and smart_filter.
• Library schedule modes for full, added, changed, alphabetical and explicitly selected items, with a --mode / KOMETA_MODE override for a single run.
• A Seerr connector that passes media requests to Radarr and Sonarr, including standard and 4K instances at the same time.
• Music work: apple_chart, itunes_chart and spotify_chart builders for per-country charts, a Last.fm connector, YouTube Music builders and an artist-image operation, music support in tautulli_popular and tautulli_top (with tautulli_watched kept as a legacy alias), and music_playlists for Music library collection files.
• An artist-level Lidarr connector with global or per-library configuration, quality-profile and monitoring updates, tag add/remove/sync and cached successful additions, plus lidarr_all and lidarr_taglist builders that match Lidarr and Plex by MusicBrainz artist ID.
• seasons: {latest: true} filtering against the highest-numbered Plex season, excluding Specials.

Fixes include TMDb episode cache writes after an episode is renumbered or moved, a clearer error for the unsupported kometa_poster and pmm_poster attributes, and more complete MDBList digital release dates.

What it means for self-hosters

If you run Kometa on a schedule, the new schedule modes and the --mode override are worth reading up on: they let you split heavy full runs from lighter incremental ones without editing configs each time. The music additions are the biggest functional jump, but they also mean more moving parts, so test them on a copy of your config first.

Before upgrading, confirm your Python version, back up your config and collection files, and run once manually to watch the logs. If you would rather not maintain the stack yourself, our Plex products may help.