v2.3.0

Important Changes

Python 3.9 is no longer supported as it is End-of-Life, please use Python 3.10+

Requirements Update (requirements will need to be reinstalled)

Updated gitpython requirement to 3.1.46
Updated pillow requirement to 12.1.0
Updated plexapi requirement to 4.18.0
Updated psutil requirement to 7.2.2
Update setuptools requirement to 82.0.0
Updated python-dotenv requirement to 1.2.1
Updated ruamel.yaml requirement to 0.19.1
Update tenacity requirement to 9.1.4

New Features

Adds | as a preferred delimiter for run times.
Adds an optional setting plex_bulk_edit_batch_size in operations to control how many items are processed in a single batch.
Adds new filters show_title and season_title
Adds Producer's Cut to resolution/edition default overlay
Adds incremental parsing support to Letterboxd user_films and user_reviews builders for improved performance with large collections
Change MDBList module to use API rather than JSON endpoint.
Add visible (X/Y) logging while processing missing items.
Add new mal_all genre option to include Explicit Genres, Themes and Demographics.
Replace AniDB scraping with purpose-built cache server. Removed popular builder. [Issue #2932]
Removes authentication-related AniDB configuration entries.
IMDB "Document is empty" no longer CRITICAL

Docs

Sync MDBList sort options with MDBList API Docs
Add docs around Plex token types, add Plex Token generation form
Tweak AniDB docs to reflect loss of tag builder and reduced config.

Defaults

Bug Fixes

Fix a logic error that caused an infinite loop on reauthentication with private Trakt Lists
Pin dockerfile to Python 3.13.x, since 3.14.1 introduces memory bloat issues
Improve API-based handling of MDBList "external" lists.
Sync MDBList sort options with MDBList API Docs
Update several networks to cater for updated names
Adjust behavior of mdb_commonsense and mdb_commonsense0 content rating operations to reflect current response from MDBList.

v2.2.2

Requirements Update (requirements will need to be reinstalled)

Updated arrapi requirement to 1.4.14
Updated lxml requirement to 6.0.2
Updated plexapi requirement to 4.17.1
Updated psutil requirement to 7.1.0
Updated ruamel-yaml requirement to 0.18.15
Updated requests requirement to 2.32.5
Updated tmdbapis requirement to 1.2.30

Important Changes

Sponsor's Images are now listed on the ReadMe, Wiki Homepage, and acknowledgements page.
Updated the Sponsorship Tier Rewards (credit to @mrbuckwheet for sponsoring and driving the updates)

New Features

Adds | as a preferred delimiter for run times.
Adds an optional setting plex_bulk_edit_batch_size in operations to control how many items are processed in a single batch.
Adds new filters show_title and season_title
Adds Producer's Cut to resolution/edition default overlay

Docs

Fixed an issue where the home page logo and shield images appeared as raw text
Fixed an issue where the builder overview page had multiple dead links
Added some clarification on Library types to defaults pages

Defaults

Add Movistar Plus + as streaming service
Add Atres Player as streaming service
Add AMC+ as streaming service
Add Filmin as streaming service
Update BAFTA Best Films to include BAFTA Award for Best Film From Any Source
Fixes #2806 separators placeholder now work with minimum items.

Bug Fixes

Don't assume details of the IMDb API response structure, offer "private list" as a possible cause of no IDs found
Fix overlay_special_text cache table schema to use TEXT for rating_key to be consistent with other tables
Fixes #2802 the list now acts as a list
Fixes logic issue with reauthenticating trakt
Fixes an issue with the dovi attribute of plex_search where shows and seasons never returned anything
Fixes .regex tag filters

v2.2.1

Requirements Update (requirements will need to be reinstalled)

Update gitpython requirement to 3.1.45
Update lxml requirement to 6.0.0
Update pathvalidate requirement to 3.3.1
Update pillow requirement to 11.3.0
Update plexapi requirement to 4.17.0
Update python-dotenv requirement to 1.1.1
Update pywin32 requirement to 311
Update requests requirement to 2.32.4
Update ruamel-yaml requirement to 0.18.14
Update setuptools requirement to 80.9.0
Update tenacity requirement to 9.1.2

Important Changes

New Features

Added file_logo and url_logo as metadata image options credit to @Joost1991
Added support for updating logos via the asset directories as well credit to @Joost1991
Added support for dovi search attribute for Plex builders (requires PMS 1.41.6.9606 or above)
IMDb episodes found in a list for a show collection will now add that episode's show to the collection
Adds force_refresh Trakt setting; this tells Kometa to refresh the token on every run without checking it first
Adds a log of the response from Trakt which triggers the "No Valid Lists" error.
Adds assets_for_all_collections library operation; this tells Kometa to add asset artwork to unmanaged and unconfigured collections

Docs

Adds overlay guide
Adds TrueNAS walkthrough
Adds notes on Github tokens
Adds screenshot of UNRaid Console menu

Defaults

[Franchise] Updates 'NCIS' list to include NCIS: Origins and NCIS: Tony & Ziva. Adds 'Spartacus', 'Death in Paradise' and 'Reacher' to the franchise lists
[Universe] Change the DC Animated Universe list to a mdblist

Bug Fixes

Fixed an issue where Playlists could not add to both Radarr and Sonarr in a single run
Fixed an issue where trakt_list_details would not find a list's summary if it was an "official" Trakt list
Fixed an issue where log file paths with >2 periods would cause a ValueError
Fixed an issue with IMDb Awards
Restored image language settings after change in base image
Fixed an issue with IMDb List and Watchlist

v2.2.0

Requirements Update (requirements will need to be reinstalled)

Add pywin32 requirement at 308 (windows only)
Add cloudscraper requirement at 1.2.71
Update gitpython requirement to 3.1.44
Update lxml requirement to 5.3.1
Update num2words requirement to 0.5.14
Update pathvalidate requirement to 3.2.3
Update pillow requirement to 11.1.0
Update plexapi requirement to 4.16.1
Update psutil requirement to 7.0.0
Update python-dotenv requirement to 1.1.0
Update pywin32 requirement to 310
Update ruamel-yaml requirement to 0.18.9
Update setuptools requirement to 78.1.0
Update tmdbapis requirement to 1.2.28

Important Changes

Python 3.8 is no longer supported. The minimum version of Python required is now 3.9.

New Features

Added the character search option to the imdb_search builder
Added ability to use Show-level ratings at the season and episode level for Overlays if the original source does not provide ratings at the season or episode level. This is accomplished using (Special Text Variables)[https://kometa.wiki/en/latest/files/overlays/#special-text-variables] but is not yet available for the Ratings Defaults file.
Add show_unfiltered setting to display items which make it through a filter
Allow sync_to_trakt_list on episode-level collections
Logic added to Kometa to create config.yml if it does not exist from the config.yml.template file. If the template file cannot be found, Kometa will attempt to download it from GitHub.
When using mass_poster_update, added ignore_locked and ignore_overlays attributes which will prevent Kometa from resetting the image if the poster field is locked (i.e. a previous mass poster update) or if the item has an Overlay. This can effectively act as a differential update system.
When using mass_background_update, added ignore_locked attribute which will prevent Kometa from resetting the image if the poster field is locked (i.e. a previous mass poster update). This can effectively act as a differential update system.
Added date option for schedules
Added the --low-priority/-lp (KOMETA_LOW_PRIORITY) command line argument option to run the process at a lower priority. credit to @planetrocky
Added trakt, omdb_metascore, omdb_tomatoes ratings sources for mass operations.
Added trakt ratings source for mass episode operations.
Added GitHub token validation during config validation.
Added plex ratings source for mass operations.
Add recently-added ratings sources to special-text overlays.
Added IMDb Interests (sub-genres) to imdb_search builder
Allow server_preroll to accept a list
Changed default overlay_artwork_filetype to webp_lossy and overlay_artwork_quality to 90
Added ntfy as a notification option
Added scale_width and scale_height overlay options.
Added tmdb_deathday credit to @Kevin2kkelly

Docs

Added "getting started" page
Added page to describe all the YAML files
Updated Synology page for DSM 7.2 and added a disclaimer about what it covers
Added "undoing changes" page
Added more detail to the "sorting" page

Defaults

Fixed incorrect content rating mappings in various Default files
Fixes an issue where Prime Video overlays/collections would not be built when the watch_region is set to AU or NL
Fixes an issue where Rotten Tomatoes Verified Hot wasn't working
Updates Alien vs Predator and X-Men lists to new lists which include most recent releases
Adds style template variable for Streaming and Chart defaults, allowing user to choose color or white logos for collection posters
Added Paramount+ with Showtime to both Paramount+ and Showtime for Networks and Streaming, any existing weighting is unchanged.
Added Aymara language with Bolivian flag to audio/subtitle overlay languages (credit to popeadam)
Added size setting to languages overlay to double the overlay size.
Added hide_text setting to languages overlay to only show the flags and hide the country text.
Added openmatte edition to default resolution overlay.
Added Metacritic Must See Movies to other_chart.
Moved several universe and playlist default lists away from Trakt and over to IMDb and MDBList
Removed default emojis from seasonal due to Plex issue with emojis and updated some lists
Removed BritBox and replaced with ITVX in streaming following service shutdown

Bug Fixes

Fixed the cast search option for the imdb_search builder
Fixes #2258 imdb_list sort was not being parsed correctly
Fixes letterboxd_list rating filter to use a 1-10 rating vs 1-100 to reflect how letterboxd ratings work on their website
Fixes #2274 Enhance handling of smart collections in deletion
Fixed the ids_to_anidb lookup for anime movies and shows
Fixes an issue where episode overlays sometimes wouldn't be added
Fixes an issue with IMDb Parental Labels not working
Fixes an issue where OMDb returned N/A as the content rating
Fixes an issue where plex_collectionless doesn't work if the item was added to a collection in the same run
Adds a page that discusses the different YAML files and what they do.
Modifies default value presentation for default metadata files.
Fixes an issue causing IMDB collection to fail due to duplicate keys
Removed Blog from the Navigation due to lack of time for updating/maintaining it
Fixes #2354 by updating version of tmdbapi dependency
Added Start Time, Finished and Run Time to Summary of run.
Fixed an issue where custom repositories would not work correctly if the URL did not end in a trailing / character.
Kometa will now check for .yaml extension in filenames if .yml is not found and vice-versa
Log files will now follow the naming convention of kometa.log, kometa-1.log (previous run), kometa-2.log (2 runs ago) etc.
Kometa will no longer automatically sync playlists to all users if you do not specify who you want to sync them to. Only the server admin will receive playlists unless otherwise specified using sync_to_users or playlist_sync_to_users
Fixes #2385 tmdb_person would pass an integer if the name started with an integer (i.e. 50 Cent would pass 50 which resolved to Catherine Deneuve)
Fixes an issue where show_missing would display missing movies against show libraries (closes #2351)
Fixed an OMDb API issue where API key would intermittently be treated as invalid
Fixed an issue where Kometa would try to upload and cache images larger than Plex allows (10mb is the upper limit)
Fixes an issue where use_subtitles would ignore flag_alignment: left
Fixed typo radarr_tag_list instead of radarr_taglist in builder module causing Collection Error: radarr_taglist attribute is blank
Fixed NoneError when using a blank radarr_taglist or sonarr_taglist.
Fixes an issue with boolean filter matching.
Fixes an issue where the decade default collection names were incorrect.
Fixes the playlist default to automatically work with a supplied list.
Remove an unnecessary request to Plex while processing overlays.
Fixes issue with ICheckMovies parsing.
Fixes issue with Letterboxd parsing.
Fixes issue with the mojo_domestic BoxOfficeMojo Builder.
Fixes an issue updating Trakt User Ratings when the show doesn't exist on TVDb.
Fixes #2560 count display issue

v2.1.0

Requirements Update (requirements will need to be reinstalled)

Added tenacity requirement at 9.0.0
Update lxml requirement to 5.3.0
Update pathvalidate requirement to 3.2.1
Update pillow requirement to 10.4.0
Update PlexAPI requirement to 4.15.16
Update psutil requirement to 6.0.0
Update setuptools requirement to 74.0.0
Update tmdbapis requirement to 1.2.21

Removed Features

New Features

Introducing the Kometa Blog - a new home for all kometa-related news stories, ranging from showcasing our community creations to providing you with important updates.
Added letterboxd_user_lists Dynamic Collection Type
Added item_analyze item detail to analyze each item in a collection

Updates

F1 session naming improvements
Added new studios : Disney Television Animation, DisneyToon Studios, Dynamic Planning, Film4 Productions, Golden Harvest, Hungry Man, Screen Gems, Shaw Brothers, Studio Live, The Stone Quarry

Defaults

Fixed #2150; change xmen list to a new one
Added A Quiet Place: Day One to the A Quiet Place collection in the franchise Defaults file
Add minimum_items_<<key>> to universe Default file
Added workaround to Streaming for TMDb issue with TMDb Discover

Bug Fixes

Fixed multiple anime int() Errors
Fixed #2100 verify_ssl wasn't working when downloading images
Fixed an issue with delete_collections where items were being deleted if they only matched one criteria vs all criteria
Fixed imdb_watchlist
Fixes #2135 AniDB Builder type conversion error
Fixed #2169 Add handling for blank secrets
Fixed #2176 clean_bundles, optimize, and empty_trash not working as global attributes
Fixed #2186 total_runtime will now trigger an overlay update
Fixed #2195 an image on the docs was a dead link
Fixes sort order of resolution collections
Fixes #2228 ".any" not accepted for a variety of imdb_search parameters
Fixes streaming defaults adding and removing items randomly
Fixes missing TMDb Discover parameters
Fixes imdb_chart error when using trending_india
Adds error information to help with #2201
Added warning to TMDb Discover builder regarding ongoing bug with using popularity.desc as sort order
Various other Minor Fixes

v2.0.2

Requirements Update (requirements will need to be reinstalled)

Updated PlexAPI requirement to 4.15.13
Update lxml requirement to 5.2.2
Update requests requirement to 2.32.3
Update schedule requirement to 1.2.2
Update setuptools requirement to 70.0.0

Removed Features

New Features

Checks requirement versions to print a message if one needs to be updated
Added the mass_added_at_update operation to mass set the Added At field of Movies and Shows.
Add automated Anime Aggregations for AniDB matching
Added total_runtime as a special text overlay variable.
Added top_tamil, top_telugu, top_malayalam, trending_india, trending_tamil, and trending_telugu as options for imdb_chart
Adds the sort_by attribute to imdb_list

Updates

Changed the overlay_artwork_filetype Setting to accept webp_lossy and webp_lossless while the old attribute webp will be treated as webp_lossy.

Defaults

Added Letterboxd Default Collections and Ribbon

Bug Fixes

Fixes #2034 anilist_userlist score attribute wasn't being validated correctly
Fixes #1367 Error when trying to symlink the logs folder
Fixes #2028 TMDb IDs were being ignored on the report
Fixes a bug when parsing a comma-separated string of ints
Fixes imdb_chart only getting 25 results
Fixes imdb_list not returning items

Various other Minor Fixes

v2.0.1

Requirements Update (requirements will need to be reinstalled)

Removed Features

New Features

Added overlay_artwork_filetype and overlay_artwork_quality settings to control the filetype and quality of overlay images. Users can select from JPG, PNG and WEBP.

Updates

Defaults

Added starting_only template variable to the mal Collection Default.
Changed streaming defaults to use names as their keys vs their TMDb IDs as keys
Fixed amazon ID in streaming when region is CA

Bug Fixes

Catch bad ID data from Plex
Fixes - git file calls
Ignore empty Environment Variables
Fixes collections being deleted under certain conditions when using translations

Various other Minor Fixes

v2.0.0

Plex Meta Manager is now rebranded as Kometa!

Requirements Update (requirements will need to be reinstalled)

Updated arrapi requirement to 1.4.13
Updated PlexAPI requirement to 4.15.12
Updated setuptools requirement to 69.5.1
Updated tmdbapis requirement to 1.2.16

Removed Features

New Features

Add Page Topics Options to imdb_search
Add lxml Docker Version using an old lxml version that supports more cpus

Updates

Add use_all template variable to default collections, which allows all collections to be disabled with one variable.
Let conditional .not and .exists work with default variables

Defaults

Bug Fixes

Fixes #1965 download_url_assets was causing url_background to upload as a poster
Fixes #1969 Ignore validating TPDb links

Various other Minor Fixes

Closed legacy issues on GitHub

v1.21.1

Requirements Update (requirements will need to be reinstalled)

Updated gitpython requirement to 3.1.43

Removed Features

New Features

Add Page Topics Options to imdb_search
Add lxml Docker Version using an old lxml version that supports more cpus

Updates

Let conditional .not and .exists work with default variables

Defaults

Bug Fixes

Fixes #1965 download_url_assets was causing url_background to upload as a poster
Fixes #1969 Ignore validating TPDb links

Various other Minor Fixes

Closed legacy issues on GitHub

v1.21.0

Requirements Update (requirements will need to be reinstalled)

Updated gitpython requirement to 3.1.43
Updated lxml requirement to 5.2.1
Updated pillow requirement to 10.3.0
Updated plexapi requirement to 4.15.11
Updated psutil requirement to 5.9.8
Updated python-dotenv requirement to 1.0.1
Updated python-dateutil requirement to 2.9.0.post0
Updated ruamel.yaml requirement to 0.18.6
Updated setuptools requirement to 69.2.0
Updated tmdbapis requirement to 1.2.9

Removed Features

Due to FlixPatrol moving a lot of their data behind a paywall and them reworking their pages to remove IMDb IDs and TMDb IDs the flixpatrol builders and default files have been removed. There currently are no plans to re-add them.

New Features

Added new BoxOfficeMojo Builder - credit to @nwithan8 for the suggestion and initial code submission
Added monitor_existing to sonarr and radarr. To update the monitored status of items existing in plex to match the monitor declared.
Added Gotify as a notification service. Thanks @krstn420 for the initial code.
Added Trakt and MyAnimeList Authentication Page allowing users to authenticate against those services directly from the wiki. credit to @chazlarson for developing the script
Added TVDb filters
Cache TMDb Episode Calls
Added Direct Rating Overlays without having to update the rating in plex
Added TPDb Rate Limit

Updates

Reworked PMM Default Streaming Collections and Overlays to utilize TMDB Watch Provider data, allowing users to customize regions without relying on mdblist. This data will be more accurate and up-to-date now.
As a result of this change, if you are using custom images with this defaults file, you must replace any mention of <<key>> in the filename with <<originals_key>>.
Added new trakt_chart attributes network_ids, studio_ids, votes, tmdb_ratings, tmdb_votes, imdb_ratings, imdb_votes, rt_meters, rt_user_meters, metascores and removed the deprecated network attribute
Trakt Builder trakt_userlist value recommendations removed and favorites added.
Mass Update operations now can be given a list of sources to fall back on when one fails including a manual source.
mass_content_rating_update has a new source mdb_age_rating
mass_originally_available_update has a new source mdb_digital
plex attributes clean_bundles, empty_trash, and optimize can now take any schedule options to be run only when desired.
Allows users to use the Admin username when specifying playlist users. Thanks @benbou8231!
Allows verify_ssl to be set specifically for plex. Thanks @FestiveKyle!
Updated Plex Item Advance Preferences.
Add new Overlay Special Text Options to directly print ratings to overlays without operations.

Bug Fixes

Fixed the Rate Limit on MDbList calls
Fixed collection fields being locked during batch edits when they shouldn't be
Fixed awards dynamic collections where latest wasn't pulling the correct values
Fixed imdb_watchlist
Fixed trakt_userlist
Fixed an issue where sometimes the resolution default overlay would be off center
Fixed multiple issues with playlist deletion. Thanks @benbou8231!
Fixed an issue where dynamic collection errors would sometimes appear before the title of the Dynamic Collection.
Fixed IMDb Null issue
Fixed mapper operations not working without a mass update operation
Fixed episode rating mass update operations
Fixed metadata backup issue where Artist, Album, and Track ratings were not being backed up
Fixed an issue with the IMDb hash changing
Fixes #1960 and #1962

Various other Minor Fixes

Closed legacy issues on GitHub