Defaults‑Image‑Creation

August 31, 2025 · View on GitHub

This repository brings together two complementary toolsets for building and maintaining visual assets used across your media libraries:

  • Cross‑Platform People Posters Pipeline (Python) — an end‑to‑end workflow that discovers missing people, fetches images, removes backgrounds, updates your People‑Images repos with a remote‑always‑wins strategy, generates README grids, and optionally pushes changes. See Orchestrator below.
  • Create Defaults (PowerShell) — a purpose‑built defaults generator that produces standardized “default” posters (genres, networks, countries, ratings, etc.) plus a one‑off poster composer. See create_defaults below.

Quick Start

Choose the path that matches your task.

A) Build / refresh People posters (Python orchestrator)

  1. Python 3.10+ and pip installed
  2. Install dependencies: 
    pip install -r requirements.txt
  3. First‑run bootstraps ./config/.env from the example: 
    python orchestrator.py --all
# then edit ./config/.env and set at least: TMDB_KEY=your_api_key
  4. Typical runs: 
    # Full publish flow (includes final push)
python orchestrator.py --steps ensure_repo,update,sync_images,readme,sync_md,push      --repo-root "/path/to/Kometa-People-Images" --style transparent

Highlights

  • Update step performs git fetch + reset --hard + clean -fdx so remote always wins (no local merge tangle).
  • Optional final push step commits and pushes only if there are changes.
  • QA helpers include image_check.py (single‑tree) and compare_image_trees.py (7‑tree matrix).

For full details of steps, env vars, and QA utilities, see the orchestrator README in this repo.

B) Generate default poster sets (PowerShell)

  1. PowerShell 7+ (pwsh) and ImageMagick (magick) on PATH
  2. Fonts used by the default styles installed system‑wide
  3. From create_defaults/: 
    # Run everything
pwsh -File ./create_defaults/create_default_posters.ps1 All

# Or pick specific sets (run in order)
pwsh -File ./create_defaults/create_default_posters.ps1 AudioLanguage Playlist Chart

What it makes (examples)

  • Audio Language, Awards, Based, Charts, Content Rating, Country, Franchise, Genres, Network, Playlist, Resolution, Streaming, Studio, Seasonal, Separators, Subtitle Language, Universe, Video Format, Year, Overlays.
  • One‑off composer create_defaults/create_poster.ps1 builds a single 2000×3000 poster from base/gradient/logo/border/text layers.

See create_defaults/README.md for requirements (ImageMagick, fonts, Windows execution policy), category details, and examples.

Repository Layout

Defaults-Image-Creation/
├─ orchestrator.py                 # cross‑platform runner for the Python pipeline
├─ config/
│  ├─ .env.example                 # copied to ./config/.env on first run
│  └─ ...                          # pipeline config, logs, QA outputs
├─ create_defaults/
│  ├─ create_default_posters.ps1   # bulk defaults generator
│  ├─ create_poster.ps1            # single‑poster composer
│  └─ README.md                    # usage & requirements for PowerShell defaults
└─ README.md                       # (this file) overview & entry points

Requirements (consolidated)

  • Python path: Python 3.10+, pip, network access to TMDB, optional Selenium/Chrome if you use background removal.
  • PowerShell path: PowerShell 7+, ImageMagick CLI (magick), required fonts (Comfortaa, Bebas, Jura, Limelight, Rye, etc.; Cairo for Arabic text).
  • Git: for People‑Images updates (SSH key or HTTPS token configured for origin).

Common Tasks

Update repos then sync new posters

python orchestrator.py --steps ensure_repo,update,sync_images,readme,sync_md,push   --repo-root "/srv/Kometa-People-Images" --style transparent

Validate generated images

# Single tree
python image_check.py --root "/srv/Kometa-People-Images/transparent" --exts png --required-size 2000x3000

# Seven-way matrix across style folders
python compare_image_trees.py --repo-root "/srv/Kometa-People-Images"

Generate a few common default sets

pwsh -File ./create_defaults/create_default_posters.ps1 Genres Resolution Studio

Troubleshooting (quick)

  • 'magick' not recognized — Install ImageMagick and reopen your shell; verify with magick -version.
  • Fonts missing / wrong glyphs — Install required fonts system‑wide so ImageMagick can find them.
  • Execution policy (Windows) — Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force
  • Nothing to push — the push step skips commit when the working tree is clean.
  • Repo drift — The update step resets to origin/<branch> each run; local changes are intentionally discarded before syncing.

Credits

  • PowerShell defaults scripts: bulk creators + one‑off composer
  • Python pipeline: orchestrator + QA utilities (image checks & matrix)