KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

meta-manager-config

★ 41 Open GitHub ↗

Kometa configs for Plex: overlays, discovery collections & artwork. Sports metadata → tvsportsdb.com

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Kometa Configs

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://raw.githubusercontent.com/s0len/meta-manager-config/main/LICENSE)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://raw.githubusercontent.com/s0len/meta-manager-config/main/docs/contributing.md)
[![Buy Me A Coffee](https://img.shields.io/badge/support-Buy%20Me%20a%20Coffee-ffdd00.svg)](https://www.buymeacoffee.com/solen)

Curated [Kometa](https://kometa.wiki) configurations for Plex libraries: battle-tested overlays, discovery collections, artwork, and a legacy archive of sports metadata — build polished libraries without hunting down artwork.

> **Looking for sports metadata?** Head to **[TVSportsDB](https://tvsportsdb.com/)** — sports metadata managed from a broadcast perspective (Shows → Seasons → Episodes), community-maintained with version history and YAML export. That's where sports metadata is actively kept up to date; the files in this repo remain online as a legacy archive so existing configs keep working.

---

## Quick Start

1. Install [Kometa](https://kometa.wiki/en/latest/).
2. For **sports**, browse [TVSportsDB](https://tvsportsdb.com/) and export the YAML for the shows you want. For **movies & TV enhancements**, jump to the [overlays and collections](#movies--tv-enhancements) below, e.g.:

```yaml
libraries:
  Movies:
    collection_files:
      - url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/collection_files/sofa_picks_movies.yaml
    overlay_files:
      - url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/background_top_left_313_wide.yml
```

3. Enable `assets_for_all: true` so Kometa fetches posters/backgrounds automatically.

A complete example config lives in [`exampleConfig.yaml`](exampleConfig.yaml).

---

## Repository Map

| Path | Description |
| --- | --- |
| `metadata/<sport>/<season>.yaml` | Hand-crafted or generated YAML per sport and season. |
| `scripts/` | Python generators for metadata and overlays — see [`scripts/README.md`](scripts/README.md). |
| `posters/` & `images/` | Published artwork plus documentation screenshots. |
| `overlays/` | Network, streaming, studio, resolution, audio, status, and ribbon overlays. |
| `collection_files/` | Drop-in collections: New Releases, Sofa Picks, and more. |
| `templates/` | Photoshop starting points for posters/title cards/overlays. |
| `docs/` | Setup guides and contribution docs. |

---

## Sports Metadata (Legacy Archive)

> ⚠️ **Actively maintained sports metadata now lives at [TVSportsDB](https://tvsportsdb.com/).** The files below stay online so existing configs keep working — posters and title cards are still hosted here — but new seasons and fixture updates land on TVSportsDB, not in this repo.

| Sport | Seasons | Metadata | Guide |
| --- | --- | --- | --- |
| Formula 1 | 2023–2025 | `metadata/formula1/<year>.yaml` | [Docs](docs/Formula1.md) |
| Formula 2 | 2025 | `metadata/formula2/2025.yaml` | — |
| Formula 3 | 2025 | `metadata/formula3/2025.yaml` | — |
| Formula E | 2024–2026 | `metadata/formula-e/<season>.yaml` | — |
| MotoGP | 2022–2025 | `metadata/motogp/<year>.yaml` | [Docs](docs/MotoGP.md) |
| Moto2 | 2025 | `metadata/moto2/2025.yaml` | — |
| Moto3 | 2025 | `metadata/moto3/2025.yaml` | — |
| IndyCar | 2025 | `metadata/indycar-series/2025.yaml` | — |
| WRC | 2024 | `metadata/wrc-2024.yaml` | — |
| European Rally (ERC) | 2024 | `metadata/erc-2024.yaml` | — |
| Isle of Man TT | Latest events | `metadata/isle-of-man-tt.yaml` | — |
| WorldSBK | 2023–2025 | `metadata/wsbk-<year>.yaml` | — |
| World Supersport | 2023–2025 | `metadata/wssp-<year>.yaml` | — |
| World Supersport 300 | 2024–2025 | `metadata/wssp300-<year>.yaml` | — |
| NBA | 2025–2026 | `metadata/nba/2025-2026.yaml` | — |
| NFL | 2025–2026 | `metadata/nfl/2025.yaml` | — |
| NHL | 2025–2026 | `metadata/nhl/2025-2026.yaml` | — |
| Premier League | 2024–2026 | `metadata/premier-league/<season>.yaml` | — |
| UEFA Champions League | 2025–2026 | `metadata/uefa-champions-league/2025-2026.yaml` | — |
| Women's UEFA Euro | 2025 | `metadata/womens-uefa-euro.yaml` | — |
| Figure Skating Grand Prix | 2025 | `metadata/figure-skating-grand-prix/2025.yaml` | — |
| UFC | 2024–2026 | `metadata/ufc/<year>.yaml` | [Docs](docs/UFC.md) |

Need another sport? Add it on [TVSportsDB](https://tvsportsdb.com/) — the generator scripts in [`scripts/`](scripts/README.md) can still bulk-build season YAML from TheSportsDB, which TVSportsDB accepts as an import.

---

## Sport Guides

- [`docs/Formula1.md`](docs/Formula1.md) – Folder layout, Kometa config, and preview shots for the full grid.
- [`docs/MotoGP.md`](docs/MotoGP.md) – Library settings, naming rules, and troubleshooting.
- [`docs/UFC.md`](docs/UFC.md) – Event numbering, metadata structure, and recommended Plex agents.
- [`docs/SportDocTemplate.md`](docs/SportDocTemplate.md) – Copy this structure when documenting a new sport.

---

## Movies & TV Enhancements

Battle-tested overlays and collections for standard Plex libraries.

### Sofa Picks – Discovery Collections

Self-maintaining "what should we watch tonight?" collections. They only surface things you *haven't* seen and refresh as you watch — Hidden Gems and Quick Watch Tonight for movies, Binge-Ready Shows and Limited Series for TV:

```yaml
libraries:
  Movies:
    collection_files:
      - url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/collection_files/sofa_picks_movies.yaml
  TV Shows:
    collection_files:
      - url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/collection_files/sofa_picks_series.yaml
```

The movie collections are pure Plex smart filters (zero external APIs); the series ones use TMDb status lookups via Kometa. Rating thresholds assume a 0-10 critic scale — tweak `.gte` values in the file to taste.

### Movies – Replacement Collections

Swap out Plex's defaults with smarter "New Releases" and "Old Movies Just Added" collections:

```yaml
- url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/collection_files/better_new_and_old_movie_releases.yaml
```

![new movie releases and old movies just added](https://github.com/s0len/meta-manager-config/blob/main/images/new-movie-releases-and-old-movies-just-added.png)

### Movies – Common Sense Collections

```yaml
- default: content_rating_cs
  template_variables:
    use_separator: false
    collection_mode: hide
    url_poster: https://raw.githubusercontent.com/s0len/meta-manager-config/main/posters/commonsense/<<key>>.jpg
```

![Common Sense collection](https://github.com/s0len/meta-manager-config/blob/main/images/commonsense-collection.jpg)

### Movies – Ribbon Background

Run this once before stacking resolution/audio/studio overlays:

```yaml
- url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/background_top_left_313_wide.yml
```

### Movies – Resolution & Audio (Horizontal)

```yaml
- default: resolution
  template_variables:
    url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/resolution-top-left-horizontal/<<overlay_name>>.png
    horizontal_align: left
    horizontal_offset: 0
    vertical_align: top
    vertical_offset: 0
    final_horizontal_offset: 0
    final_vertical_offset: 0
    back_width: 1000
    back_height: 1500
    back_color: 00
- default: audio_codec
  template_variables:
    url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/audio-top-left/<<key>>.png
    horizontal_align: left
    horizontal_offset: 0
    vertical_align: top
    vertical_offset: 0
    back_width: 1000
    back_height: 1500
    back_color: 00
```

![movies_resolution_audio_codec_horizontal](https://github.com/s0len/meta-manager-config/assets/35483234/55b9f52c-e057-4a47-939a-4819b50ba4d0)

### Movies – Resolution & Audio (45°)

```yaml
- default: resolution
  template_variables:
    url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/resolution-top-left-45deg/<<overlay_name>>.png
    horizontal_align: left
    horizontal_offset: 0
    vertical_align: top
    vertical_offset: 0
    final_horizontal_offset: 0
    final_vertical_offset: 0
    back_width: 1000
    back_height: 1500
    back_color: 00
- default: audio_codec
  template_variables:
    url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/audio-top-left-45deg/<<key>>.png
    horizontal_align: left
    horizontal_offset: 0
    vertical_align: top
    vertical_offset: 0
    back_width: 1000
    back_height: 1500
    back_color: 00
```

![movies_resolution_audio_codec_45degree](https://github.com/s0len/meta-manager-config/assets/35483234/bbb9469c-8190-441d-a23f-9405af21ab7c)

### Movies – Studio & Ribbon Badges

```yaml
- default: studio
  template_variables:
    horizontal_align: left
    horizontal_offset: 0
    vertical_align: top
    vertical_offset: 0
    back_width: 1000
    back_height: 1500
    url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/studio-top-left/<<key_encoded>>.png
    back_color: 00
- url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/ribbon_awards.yml
- url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/ribbon_trending.yml
- url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/ribbon_imdb.yml
- url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/ribbon_rotten.yml
```

![studio overlay movies](https://github.com/s0len/meta-manager-config/assets/35483234/467d2aa1-afc7-4d7e-b038-425492e1c880)
![movies_awards](https://github.com/s0len/meta-manager-config/assets/35483234/24b8f0c2-74aa-4395-8265-ca0c6820a38b)
![movies_imdb](https://github.com/s0len/meta-manager-config/assets/35483234/6dfa41b0-568c-4a20-846c-753792f34929)
![movies_rotten](https://github.com/s0len/meta-manager-config/assets/35483234/6b0a7070-e5e3-4e13-aed5-73e1ab2cc8bf)

### TV – Title Cards (Community-Maintained)

Beautiful episode title cards, season posters, and show art for 450+ series, curated from [MediUX](https://mediux.pro) sets and keyed by TVDB id — one URL covers your whole library and grows over time:

```yaml
libraries:
  TV Shows:
    metadata_files:
      - url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/metadata/series/title_cards.yaml
```

Missing a show? PRs are very welcome — add your show's TVDB id with a MediUX set, keep the credit comment format, and it ships to everyone. See [`docs/contributing.md`](docs/contributing.md).

### TV – Replacement Collections

```yaml
- url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/collection_files/better_new_and_old_tv_shows_releases.yaml
```

![new tv show releases and old TV Shows just added](https://github.com/s0len/meta-manager-config/blob/main/images/new-movie-releases-and-old-tv-shows-just-added.png)

### TV – Status + Network Overlays

Over 300 network ribbons ship in `overlays/network-top-left/` — from the big streamers down to regional broadcasters. `<<key_encoded>>` is required so networks like `#0` and `U&Dave` resolve correctly. The fallback file adds a Plex ribbon for shows whose network has no artwork, plus specific artwork for networks that Kometa's defaults miss:

```yaml
- default: status
  template_variables:
    text_airing: .
    url_airing: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/status-top-left/airing.png
    text_returning: .
    url_returning: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/status-top-left/continuing.png
    text_canceled: .
    url_canceled: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/status-top-left/cancelled.png
    text_ended: .
    url_ended: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/status-top-left/ended.png
    horizontal_align: left
    horizontal_offset: 25
    vertical_align: top
    vertical_offset: 0
    font_size: 1
    font_color: '#00000000'
    back_color: '#00000000'
    back_width: 1000
    back_height: 1500
    back_padding: 0
    back_line_width: 1000
    final_horizontal_offset: 0
    final_vertical_offset: 0
- url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/network_fallback.yml
- default: network
  template_variables:
    horizontal_align: left
    horizontal_offset: 0
    vertical_offset: 0
    vertical_align: top
    back_width: 1000
    back_height: 1500
    url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/network-top-left/<<key_encoded>>.png
    back_color: 00
```

![series_status_network_overlay](https://github.com/s0len/meta-manager-config/assets/35483234/f3a64377-b16b-46bc-9a77-4852f3695db4)

### TV – Studio & Streaming Overlays

```yaml
- default: studio
  template_variables:
    horizontal_align: left
    horizontal_offset: 0
    vertical_align: top
    vertical_offset: 0
    back_width: 1000
    back_height: 1500
    url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/studio-top-left/<<key_encoded>>.png
    back_color: 00
- default: streaming
  template_variables:
    horizontal_align: left
    horizontal_offset: 0
    vertical_offset: 0
    vertical_align: top
    back_width: 1000
    back_height: 1500
    url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/streaming-top-left/<<key_encoded>>.png
    back_color: 00
```

![studio overlay shows](https://github.com/s0len/meta-manager-config/assets/35483234/c5763240-abdd-4810-860c-5d78eef07521)

### TV – Award/Trending/Rating Ribbons

```yaml
- url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/ribbon_awards.yml
- url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/ribbon_trending.yml
- url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/ribbon_imdb.yml
- url: https://raw.githubusercontent.com/s0len/meta-manager-config/main/overlays/ribbon_rotten.yml
```

---

## Automation & Scripts

Everything under `scripts/` is documented in [`scripts/README.md`](scripts/README.md). Highlights:

- **Metadata generators** – one per sport, built on TheSportsDB (`generate_<sport>_metadata_sportsdb.py`). They emit season YAML and download artwork in one pass — useful for bulk-building a season to import into [TVSportsDB](https://tvsportsdb.com/), which is where sports metadata is maintained nowadays.
- **`generate_network_overlay.py`** – create a new network ribbon PNG from any logo, no Photoshop needed. It reproduces the exact style of the existing set. Missing your favorite channel? Generate it and open a PR.
- **`generate_resolution_overlay.py`** – same idea for the 45° resolution/edition text overlays (this is how the HLG set was made).
- **`validate_yaml.py`** – checks that every YAML file parses and that internal asset references resolve. Runs automatically on every PR.

---

## Contributing

Read [`docs/contributing.md`](docs/contributing.md) for the full workflow. Highlights:

- Fork → branch → PR with screenshots where helpful.
- Run `python3 scripts/validate_yaml.py` before submitting — CI runs it on every PR.
- Name new files `.yaml` (existing `.yml` files keep their names: their URLs are live in other people's configs).
- Asset filenames must match metadata references exactly; posters are 1000×1500 JPG, title cards 1920×1080.
- Photoshop templates live in `templates/` if you want to match the house style, and the overlay generator scripts cover most cases without Photoshop.

---

## Support

Questions? [Open an issue](https://github.com/s0len/meta-manager-config/issues) or reach out on Discord (`@s0len`).
If these configs save you time, consider supporting the work:

meta-manager-config

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README