s8n/legacy-arrflix
s8n/legacy-arrflix
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
legacy-arrflix/playbooks
History
s8n 7eb5f346fd
Some checks are pending
secret-scan / gitleaks (HEAD + history) (push) Waiting to run
Details
secret-scan / detect-secrets (entropy + cross-tool) (push) Waiting to run
Details
secret-scan / summary (push) Blocked by required conditions
Details
subs: add source-priority tier ladder, accept original-release bitmap as tier 2 
Original-release bitmap subs (PGS, VobSub, dvd_subtitle) are first-class,
not stop-gaps. They're the canonical studio render — bitmap encoding is
just a format choice, not a quality compromise. OCR'd or AI-rebuilt
sidecars introduce transcription error that the source doesn't have.

STYLE.md changes:
- New "Source priority" section with 4 tiers: original text > original
  bitmap > trusted text rips > WhisperX rebuild.
- "What lands on disk" loosened: at least one English stream (embedded
  OR sidecar), keep embedded codec as-is, sidecar still .srt.
- New "OCR bitmap -> text" section documenting pgsrip recipe as an
  optional UX-nicety augmentation, not a correctness fix.
- "Why these rules" now explains why original > pretty (esp. for older
  shows like Futurama S1-3 / early Archer where the master is the only
  authoritative source and upscale artifacts already dominate).

STOPGAP-SUBS.md: header note clarifying bitmap-from-disc is NOT a
stop-gap; lists Lilo & Stitch (2002) and Archer (2009) S02 as examples
of correct-as-shipped library entries.
2026-05-10 21:22:32 +01:00
..
import-media playbooks/import-media: v1.1 — fix two Jellyfin endpoint bugs + nullstone alias 2026-05-10 06:49:17 +01:00
subtitles subs: add source-priority tier ladder, accept original-release bitmap as tier 2 2026-05-10 21:22:32 +01:00
README.md playbooks/ rename + import-media v1.0 + lilo&stitch run 2026-05-10 02:29:57 +01:00

README.md

playbooks/ — repeatable acquisition workflows

Runbook-style playbooks for repeatable ARRFLIX ops — subtitles, importing media, artwork, metadata, episode stills, and any other recurring acquisition or maintenance procedure. Each playbook is a standalone recipe Claude Code (or a human operator) can execute end-to-end.

This folder holds the canonical recipes for acquiring external content for the ARRFLIX library: subtitles, artwork, metadata, episode stills, etc. Internal ops (encoding, importing, theming) stay in bin/ and docs/.

Each playbook is its own sub-folder with three files:

File Purpose
README.md The canonical recipe. Step-by-step, executable by Claude Code. Always reflects the latest version.
CHANGELOG.md Why the recipe changed, version-by-version. One entry per breakage that forced a revision.
runs/<show>.md Evidence log: what happened when this recipe was applied to a specific show.

Recipes evolve via the iteration model: apply to a show, succeed or break, amend the recipe to handle the new case + every prior case, retry. A recipe that "just works" is one that has survived every show in the library without amendment for a full sweep.

Children

Playbook Status Last touched
subtitles/ v3.5 — YouTube auto-CC added as stop-gap for shows with no community subs anywhere (verified via 3-agent research run). AD 49/58 + Sassy 5/5. v4 WhisperX planned (ROADMAP H5) 2026-05-10