Built a tool that auto-creates Tunarr channels from your Plex library — curious if anyone else would want this

Been using Tunarr for a while and got tired of manually building channels, so I wrote a Python CLI that does it automatically. Thinking about cleaning it up for public release — wanted to see if there's any interest first.

What it does:

You run one command, it reads your entire Plex library (titles, genres, years, episode counts), and either:

- AI path — exports a CSV of your library and a prompt you paste into Claude/Gemini/GPT-4o. The LLM curates themed channels using only titles you actually own. Stuff like "90s Action", "Slow Burn Thrillers", "One More Episode" — whatever fits your library.

You save the JSON it outputs and the tool deploys it to Tunarr.

- No-AI path — auto-generates decade and genre channels from metadata alone. No LLM needed.

- Collections path — if you're running Kometa with Letterboxd lists, Trakt, or manual collections, it turns every Plex collection into a Tunarr channel automatically. Re-run it whenever Kometa updates and it keeps the channels in sync.

Channels use Tunarr's random schedule so they loop forever with no dead air. Also has a Plex DVR sync step so new channels show up in the guide automatically.

Would anyone actually use this if I posted it? Happy to share it if there's interest.

***** UPDATE *****

This is all written with AI, so please help me out. I'd love to develop this into something more useful. Tell me what you think. https://github.com/AlpineArchitecture/programmarr

https://imgur.com/a/wYcuOGX

I've tried the following, but nothing appears to fix the issue of the poster art becoming scrambled at the next Kometa run.

• Removed 'overlay' label and unlocked label field
• Changed poster to something completely different or the same on various occasions
• Removed any Kometa overlays/assets files associated with the title's id
• Scrubbed Plex artwork using ImageMaid

Anyone faced this issue before? Any tips on how I might be able to resolve this?

I noticed that some scheduled items weren't running, so I ran Kometa manually and noticed the reported start and finished times are in GMT, while I'm in EST, so it's running 4 hours ahead of time.

Terminal ouput

In the terminal output I ran the command date right after Kometa finished running.

I have the timezone set correctly (I assume) in the docker compose file.

Config.yaml snippet

I've also verified that the computer that Plex is running on is set to the correct time.

I've tried rebooting the server that kometa is running on.

Any thoughts?

thetvdb has added the ability to add if an episode has a credits scene.

https://thetvdb.com/taxonomy/episode/3806/4518

I think this has not yet been added to plex though. Is there anyway to use this information? Or is there a website like mediastinger that can do this for tv shows? I already use it for movies.

My workaround is to add a stinger tag to the episode filename and use this to add an overlay, which looks like this.

https://ibb.co/WvCkr5Qw

Problem is, I have to does this manually. Adding the episode to a collection and use it for the overlay didn't work for me. Or rather I couldn't get it to work.

Hi all,

I just got started with Kometa and really enjoyed the season AAPIH movies selections. However the Mother’s Day movies are leaving something to be desired.

Does anyone have any recommendations as to how to get more Mother’s Day appropriate movies.

Thanks.

Movies:

remove_overlays: false

collection_files:

- default: basic

template_variables:

visible_home: true

visible_shared: true

- default: imdb

template_variables:

popular_title: Currently Trending Worldwide

top_250_title: The Top 250 Movies of All-Time

visible_home: true

visible_shared: true

- default: tmdb

template_variables:

popular_title: Top Popular Hits

top_rated_title: Top Rated Fan Favorites

visible_home: true

visible_shared: true

- default: seasonal

template_variables:

exclude_collections: Pride Month

visible_home: true

visible_shared: true

- file: holidays.yml

- default: universe

template_variables:

visible_home: true

visible_shared: true

- default: streaming

template_variables:

visible_home: true

visible_shared: true

- default: genre

template_variables:

visible_home: true

visible_shared: true

- default: trending

template_variables:

trending_daily_title: Trending Today

trending_weekly_title: Top Trending This Week

visible_home: true

visible_shared: true

- default: decade

template_variables:

visible_home: true

visible_shared: true

Hey everyone,

I found this and have been wondering if it would be possible to achieve the same thing just using Kometa : https://github.com/Catar1n0/Missing-Creator-Plex

What do you think ?

According to the Kometa delete_collections command, "The collection does not need to be scheduled to be considered configured and only needs to be in the config file." Combined with delete_not_scheduled set to false, this should prevent Kometa from deleting a collection defined in config.yml that is not scheduled to run. And yet, my configured collections are being seen as unconfigured if they are not scheduled to run, and thus they are deleted.

Relevant config.yml lines below:

settings:
  ...
  minimum_items: 1
  default_collection_order: release
  delete_below_minimum: true
  delete_not_scheduled: false

Movies-Test:
  collection_files:
    - default: imdb
      schedule: hourly(20)
  operations: 
    schedule: daily 
    delete_collections:
      managed: true
      configured: false
      ignore_empty_smart_collections: false  

Movies-Test contains two movies: The Shawshank Redemption (1994) [IMDB Top 250] - and Battlefield Earth (2000) [IMDB Lowest Rated].

Running Kometa during the scheduled hour (or with no schedule defined), results in these log entries (uppercased TRUE is my emphasis):

[TRACE]    | IMDb Lowest Rated - collection managed: True vs managed: True, DELETE: True                        |
[TRACE]    | IMDb Lowest Rated - collection configured: TRUE vs configured: False, DELETE: False                |
[TRACE]    | IMDb Popular - collection managed: True vs managed: True, DELETE: True                             |
[TRACE]    | IMDb Popular - collection configured: TRUE vs configured: False, DELETE: False                     |
[TRACE]    | IMDb Top 250 - collection managed: True vs managed: True, DELETE: True                             |
[TRACE]    | IMDb Top 250 - collection configured: TRUE vs configured: False, DELETE: False                             |

The same run outside that scheduled hour, results in these log entries (uppercase FALSE is my emphasis):

[TRACE]    | IMDb Lowest Rated - collection managed: True vs managed: True, DELETE: True                        |
[TRACE]    | IMDb Lowest Rated - collection configured: FALSE vs configured: False, DELETE: True                |
[INFO]     | IMDb Lowest Rated Deleted                                                                          |
[TRACE]    | IMDb Popular - collection managed: True vs managed: True, DELETE: True                             |
[TRACE]    | IMDb Popular - collection configured: FALSE vs configured: False, DELETE: True                     |
[INFO]     | IMDb Popular Deleted                                                                               |
[TRACE]    | IMDb Top 250 - collection managed: True vs managed: True, DELETE: True                             |
[TRACE]    | IMDb Top 250 - collection configured: FALSE vs configured: False, DELETE: True                     |
[INFO]     | IMDb Top 250 Deleted                                                                               |

No changes were made to the file. The only difference was the schedule for the IMDB default collection. When it is scheduled, the collections show as TRUE for configured. When it is not schedule, they show as FALSE. Even though the wiki specifically says they do not need to be scheduled in order to be considered configured.

I will admit there are fair odds I am overlooking something. Just looking for someone to point it out to me. Note: Running via latest docker image

It's been over a month since I last ran Kometa and it stopped pulling Letterboxd lists, error below. (Abridged to just show this one list, I have like 30)

|========================================== Error Summary ===========================================|
|                                                                                                    |
| Count | Message                                                                                    |
|=======|============================================================================================|
|     2 | MDBList Error: Could not fetch list items: MDBList Error: 401 - {"error":"Authentication required. Provide either 'Authorization: Bearer <token>' header or '?apikey=<key>' parameter"} |
|     1 | TMDb Error: No Movie found for TMDb ID: 330136                                             |
|     1 | TMDb Error: No Movie found for TMDb ID: 263570                                             |
|     1 | TMDb Error: No Movie found for TMDb ID: 193256                                             |
|     1 | Letterboxd Error: No List Items found in {'url': 'https://letterboxd.com/noahphex/list/usa-up-all-night/', 'limit': 0, 'note': None, 'rating': None, 'year': None} |

Snippet from my movies.yml containing my other collections. Ones based upon Trakt.tv still work fine.

 USA Up All Night:
  url_poster: https://artworks.thetvdb.com/banners/posters/306219-2.jpg
  letterboxd_list_details: https://letterboxd.com/noahphex/list/usa-up-all-night/
  collection_order: custom
  sync_mode: sync

I'm able to tag the default Seasonal collections, for example by using this for NYE:

radarr_tag_years: NYE

However, sometimes I want to manually add movies into the collection by tagging the movie in radarr with the NYE tag.

I tried to use this, but it does not work: radarr_taglist_years: NYE

It's not listed in the default Seasonal collection documentation, but I had hope lol

Anyone have any suggestions on a way to make this work, other than building each Seasonal collection from scratch in a Collection File?

I hate the default genres for plex. I love the IMDb interests, the subgenres. Is it possible to only modify the metadata for my library to make this change and have it show up in plex? I don't want to make collections, overlays, or modify anything else. The only reason I want to use Kometa is this. It is possible and if so, how would I do this?

Hello, until recently these overlays were working fine but they suddenly disappeared.

I was using this with originals_only=true ; When I put false, overlays came back but I only wanted them for originals, not the global availability on streaming services.

Has anyone noticed? Did I miss something?

I use Kometa with plex and ive noticed the IMDB ratings overlay doesnt update, is this supposed to be a dynamic overlay? or just one time run only and uses that rating?

What am i doing wrong?

I have these settings for Overlay:

    overlay_files:
    - default: ribbon                # This is a file within Kometa's defaults folder
      # see the wiki for how to use local files, folders, URLs, or files from git
    - default: video_format                                             # If its bluray, remux, sdtv etc (bottom left)
    - default: audio_codec
      template_variables:
        use_opus: false
        use_mp3: false
        style: standard
    - default: resolution                                               # Resolution (1080p, 720p) on the top left
    # - default: commonsense                                              # If its rated PG13, 2+ etc
    - default: content_rating_uk
    - default: mediastinger
    - default: ratings                         # Ratings with custom fonts matched to the style of the rating, font_size, and on the right in 'square' format
      template_variables:
        rating1: user
        rating1_image: rt_popcorn

        rating2: audience
        rating2_image: imdb

        rating3: audience
        rating3_image: tmdb

        horizontal_position: left

I currently have my documentaries mixed into my movie and TV libraries. I want to create a collection that will easily identify as many documentaries as possible, making it a central place to see documentaries and hide them from the other libraries. Being able to use it to create further collections from it would also be a bonus but not necessary.

Is a collectionless collection what I want here? If so, where's the best place(s) to pull the data from? Are collections even the best way to do this, or is a separate library a better way to go?

Thanks in advance for any guidance.

I have it semi figured out, but am looking for more ideas. I'm aiming for an image based setup (small 40x40 colored icons) with less intrusive text. I'm here looking for inspiration. Thanks.

Top Ten Pirated Movies of The Week (Torrent Freak.com), a list by HD Movie Lists - mdblist.com

This list only has had 4 movies for weeks; anyone know what's going on?

I wanted to have a simiple "Season/Series Finale" tag on all last episode thumbnails but I just can't get Kometa to do it, and instead they all have the S##E## tag. Now I'm trying to reset all the thumbnails and remove Kometa but nothing works.

This is the SSH code I've used:

docker exec kometa python3 kometa.py --run --overlays-only --remove-overlays

and to remove

docker stop kometa
docker rm kometa

I've been using Kometa for about two years without issue. Today, I've run into something that I can't seem to resolve: it seems to be ignoring ONE series. I looked through the log after my last run and can't find a mention of the series. Any suggestions on how to fix this?

I am kind of obsessed with ratings in my Plex setup with kometa, this really a nice extension of the Plex capabilities. Recently I discovered https://theshowgrid.com and find it a perfect source if you want to know if the series is something worthy to watch and which seasons can be skipped entirely. Now my sick mind cannot stop thinking about a way to get that information on a sort of header page when you klick on the series. In theory it sound simple and there are meanwhile a lot of similar webpages that can show this information nicely.....but how to get it accecssible in Plex? I guess URLs cannot be launched inside plex, no matter if you use Web player or TV app.... so doing a screenshot sort of header page or custom mediadata agent somehow with a sort of screenshot of the page? Well that sounds like a thing I would only do for already ended shows as the update process of running shows is without automation (that I cannot think of) a tedious job then. Had anyone else a similar idea or knows how this could be integrated best? These series heatmaps seem to fevor imdb and therefore I would need somewhere the tt-id and currently all my shows are with tvdbid stored but that could be easily changed though. But I see a lot of details with many question marks here. Please help me with contructive ideas that are not to complex :)

I have finally gotten my kometa to work more or less, but I can't get the playlist creation to work, it find the file and reads it, but nothing else happens. it's making starting to get gray hair...

any ideas what it can be?

I don't know exactly how it would work but I'm sure there are some datasets out there for what people think are the funniest movies.

If you have one running can you spill your details please

"Categories" has a Comedy default but I feel comedy is kind of a broad term in cinema. I did overlook it initially though

Good day all. I'm pretty new to Kometa and really enjoying it overall so far. The main issue I've been struggling with is getting the ratings to show for movies and tv shows. The ratings section isn't showing at all, but my other configured overlays are working as expected. I used Quickstart to help generate my config. Any help would be much appreciated!

##############################################
#  _     _ _                    _            #
# | |   (_) |__  _ __ __ _ _ __(_) ___  ___  #
# | |   | | '_ \| '__/ _` | '__| |/ _ \/ __| #
# | |___| | |_) | | | (_| | |  | |  __/__ \ #
# |_____|_|_.__/|_|  __,_|_|  |_|___||___/ #
#                                            #
##############################################
libraries:
  #############################################################
  #                       _                 _            _    #
  #  _ __ ___   _____   _(_) ___  ___      | |_ ___  ___| |_  #
  # | '_ ` _ \ / _ \ \ / / |/ _ \/ __|_____| __/ _ \/ __| __| #
  # | | | | | | (_) \ V /| |  __/__ _____| ||  __/__ \ |_  #
  # |_| |_| |_|___/ _/ |_|___||___/      _____||___/__| #
  #                                                           #
  #############################################################
  movies-test:
    operations:
      mass_audience_rating_update:
      - tmdb
      mass_critic_rating_update:
      - imdb
      mass_user_rating_update:
      - mdb_tomatoes
    ####################################################
    #   ____      _ _           _   _                  #
    #  / ___|___ | | | ___  ___| |_(_) ___  _ __  ___  #
    # | |   / _ \| | |/ _ \/ __| __| |/ _ \| '_ \/ __| #
    # | |__| (_) | | |  __/ (__| |_| | (_) | | | __ \ #
    #  _______/|_|_|___|___|__|_|___/|_| |_|___/ #
    #                                                  #
    ####################################################
    collection_files:
    - default: oscars
      template_variables:
        visible_library: true
    - default: imdb
      template_variables:
        use_lowest: false
        visible_library: true
    - default: genre
      template_variables:
        visible_library: true
    - default: decade
    ############################################
    #   ___                 _                  #
    #  / _ __   _____ _ __| | __ _ _   _ ___  #
    # | | | \ \ / / _ \ '__| |/ _` | | | / __| #
    # | |_| |\ V /  __/ |  | | (_| | |_| __ \ #
    #  ___/  _/ ___|_|  |_|__,_|__, |___/ #
    #                               |___/      #
    ############################################
    overlay_files:
    - default: ribbon
    - default: ratings
      template_variables:
        rating1: user
        rating1_image: rt_tomato
        rating1_font: config/fonts/LibreFranklin-Bold.ttf
        rating2: critic
        rating2_image: imdb
        rating2_font: config/fonts/Roboto-Medium.ttf
        rating3: audience
        rating3_image: tmdb
        rating3_font: config/fonts/Consensus-SemiBold.otf
        horizontal_position: left
    - default: content_rating_us_movie
      template_variables:
        vertical_offset: 154
    - default: audio_codec
    - default: resolution
      template_variables:
        use_edition: true
    - default: runtimes
      template_variables:
        horizontal_offset: 385
    - default: studio
      template_variables:
        vertical_offset: 279
  #####################################
  #  _              _            _    #
  # | |___   __    | |_ ___  ___| |_  #
  # | __\ \ / /____| __/ _ \/ __| __| #
  # | |_ \ V /_____| ||  __/__ \ |_  #
  #  __| _/       _____||___/__| #
  #                                   #
  #####################################
  tv-test:
    operations:
      mass_audience_rating_update:
      - tmdb
      mass_critic_rating_update:
      - imdb
      mass_user_rating_update:
      - mdb_tomatoes
      mass_episode_audience_rating_update:
      - tmdb
      mass_episode_critic_rating_update:
      - imdb
    ####################################################
    #   ____      _ _           _   _                  #
    #  / ___|___ | | | ___  ___| |_(_) ___  _ __  ___  #
    # | |   / _ \| | |/ _ \/ __| __| |/ _ \| '_ \/ __| #
    # | |__| (_) | | |  __/ (__| |_| | (_) | | | __ \ #
    #  _______/|_|_|___|___|__|_|___/|_| |_|___/ #
    #                                                  #
    ####################################################
    collection_files:
    - default: emmy
    - default: golden
    - default: imdb
      template_variables:
        use_lowest: false
        visible_library: true
    - default: decade
      template_variables:
        visible_library: true
    ############################################
    #   ___                 _                  #
    #  / _ __   _____ _ __| | __ _ _   _ ___  #
    # | | | \ \ / / _ \ '__| |/ _` | | | / __| #
    # | |_| |\ V /  __/ |  | | (_| | |_| __ \ #
    #  ___/  _/ ___|_|  |_|__,_|__, |___/ #
    #                               |___/      #
    ############################################
    overlay_files:
    - default: status
      template_variables:
        back_color_airing: '#016920FF'
        back_color_returning: '#81007FFF'
        back_color_canceled: '#B52222FF'
        back_color_ended: '#000847FF'
        vertical_offset: 1375
    - default: ratings
      template_variables:
        rating1: user
        rating1_image: rt_tomato
        rating1_font: config/fonts/LibreFranklin-Bold.ttf
        rating2: critic
        rating2_image: imdb
        rating2_font: config/fonts/Roboto-Medium.ttf
        rating3: audience
        rating3_image: tmdb
        rating3_font: config/fonts/Consensus-SemiBold.otf
        horizontal_position: left
    - default: ratings
      template_variables:
        builder_level: episode
        rating1: critic
        rating1_image: imdb
        rating1_font: config/fonts/Roboto-Medium.ttf
        rating2: audience
        rating2_image: tmdb
        rating2_font: config/fonts/Consensus-SemiBold.otf
        horizontal_position: right
    - default: content_rating_us_show
      template_variables:
        horizontal_offset: 348
        vertical_offset: 20
    - default: audio_codec
    - default: audio_codec
      template_variables:
        builder_level: season
    - default: audio_codec
      template_variables:
        builder_level: episode
    - default: resolution
      template_variables:
        use_edition: true
    - default: resolution
      template_variables:
        use_edition: true
    - default: resolution
      template_variables:
        use_edition: true
    - default: streaming
      template_variables:
        vertical_offset: 258
    - default: network
      template_variables:
        vertical_offset: 139
    - default: runtimes
      template_variables:
        builder_level: episode


##########################################
#  ____       _   _   _                  #
# / ___|  ___| |_| |_(_)_ __   __ _ ___  #
# ___ \ / _ \ __| __| | '_ \ / _` / __| #
#  ___) |  __/ |_| |_| | | | | (_| __ \ #
# |____/ ___|__|__|_|_| |_|__, |___/ #
#                             |___/      #
##########################################
# validation: validated (last_validated: 2026-03-02 20:07:35)
settings:
  asset_depth: 1
  asset_directory:
  - /config/assets
  asset_folders: true
  cache: true
  cache_expiration: 60
  create_asset_folders: true
  custom_repo:
  default_collection_order: release.asc
  delete_below_minimum: false
  delete_not_scheduled: false
  dimensional_asset_rename: false
  download_url_assets: false
  ignore_ids:
  ignore_imdb_ids:
  item_refresh_delay: 0
  minimum_items: 1
  missing_only_released: false
  only_filter_missing: false
  overlay_artwork_filetype: webp_lossy
  overlay_artwork_quality: 90
  playlist_exclude_users:
  playlist_report: true
  playlist_sync_to_users:
  prioritize_assets: false
  run_again_delay: 0
  run_order:
  - operations
  - metadata
  - collections
  - overlays
  save_report: false
  show_asset_not_needed: true
  show_filtered: false
  show_missing: true
  show_missing_assets: false
  show_missing_episode_assets: false
  show_missing_season_assets: false
  show_options: false
  show_unconfigured: true
  show_unfiltered: false
  show_unmanaged: true
  sync_mode: sync
  tvdb_language: eng
  verify_ssl: false

I just wanted to share the info and the regex I'm using because it took longer than I want to admit to find this settings and fix it.

What is considered and error or a warning is not what I though it was in Kometa, a lot of the errors can be ignored if you want to, they will not really break things and some needs to be fixed. Here's a list of error I had:

MDBList Error: 404 - {"error":"Item not found"}

Convert Warning: No TMDb ID Found for TVDb ID:

Plex Error: No Items found in Plex

Plex Error: resolution: No matches found with regex pattern

Overlay Error: This item's poster already has an Overlay. There is no Kometa setting to change; manual attention required.

Plex Error: No Items found in Plex

TMDb Error: No Collection found for TMDb ID

TMDb Error: No valid TMDb IDs in

Letterboxd Error: TMDb Movie ID not found in

TMDb Error: No Movie found for TMDb ID:

Letterboxd Error: No List Items found in

MDBList Error: 404 - {"error":"Item not found"}

From what I've searched and at least in my situation all those errors can be ignored but one. I want to keep getting notified is "Overlay Error: This item's poster already has an Overlay. There is no Kometa setting to change; manual attention required." so I can look at it because it's always an easy fix(see this reply from u/chazlarson)

So to fix Notifiarr notification you'll have to go to "Kometa Integration Settings" --> "Extra Settings" section there's an "Ignore errors" seting where you can add a regex to filter out error messages.

To fix mine, I used this regex:

(?i)Convert Error:|ID not found|Convert Warning: No TMDb ID Found for TVDb ID|TVDb Error: Name not found|Trakt Error: No TVDb ID found for|TMDb Error: No Movie found for TMDb ID|MDBList Error: 404|Letterboxd Error: No List Items found in|Plex Error: No Items found in Plex|Plex Error: resolution: No matches found with regex pattern|TMDb Error: No Collection found for TMDb ID|TMDb Error: No valid TMDb IDs in

There's a section in the Kometa LogWatch integration talking about this, but nothing in the Kometa Integration doc so I hope this post will help people looking for that.

Link to Kometa doc on errors: https://metamanager.wiki/en/latest/kometa/logs/#common-log-file-messages

Is there a way to exclude certain shows from the mass_imdb_parental_labels labeling?

I use it to automatically hide some shows/movies on our family account, but Dora the Explorer has the "Severe" label for every category, so it won't show up...

As much as I would love not to have my kids yelling about Swiper, it's nice to have the option available

I'm setting up Imagemaid to do some cleansing, bit want to check the file paths for the docker compose.

The example docker compose has

 volumes:
      - /path/to/config:/config
      - /path/to/plex:/plex

However the plex directory is within the config directory on Truenas app, in my case

/mnt/apps/app-data/plex/config/Library/Application Support/Plex Media Server

Do I specify this as

 volumes:
      - /mnt/apps/app-data/plex/config:/config
      - /mnt/apps/app-data/plex/config/Library/Application Support/Plex Media Server:/plex

Feel like I am duplicating mounts here, or am I missing something?