How godkillersajal/promo-finder works
Promo Finder turns episode screenplay files into ranked, ready-to-post short-form promos. The documented workflow parses timed blocks, asks Gemini to identify promo candidates, validates and repairs cuts in code, creates trailers, judges and ranks the results, then writes CSV, JSON, raw replies, and a run log. The README describes these stages and the model’s role; the sampled source is partial, so internal call relationships beyond that documentation are not inferred.
Main entry points: promo_finder.py Model requests and cache
Components 13
Script intake
- Episode scripts
- Timed-block parser
promo_finder.py - Numbered script blocks
promo_finder.py
Promo creation
- Series bible
promo_finder.py - Episode promo candidates
promo_finder.py - Cut validation and repair
promo_finder.py - Trailer selection and cuts
promo_finder.py
Evaluation and ranking
- Promo judging
promo_finder.py - Scoring and ranking
promo_finder.py
Model and output
- Model requests and cache
promo_finder.py - Promo result files
promo_finder.py
Other components
- Show editor
- Google Gemini
Connections 17
- Show editor → Episode scripts: provides
README.md - Episode scripts → Timed-block parser: reads scripts
README.md - Timed-block parser → Numbered script blocks: numbers and times
README.md - Numbered script blocks → Series bible: provides episode context
README.md - Series bible → Model requests and cache: requests synthesis
README.md - Model requests and cache → Google Gemini: sends model calls
README.md - Google Gemini → Model requests and cache: returns judgments
README.md - Numbered script blocks → Episode promo candidates: provides script blocks
README.md - Episode promo candidates → Model requests and cache: requests candidates
README.md - Model requests and cache → Cut validation and repair: returns candidate cuts
README.md - Cut validation and repair → Trailer selection and cuts: provides validated moments
README.md - Trailer selection and cuts → Model requests and cache: requests trailer picks
README.md - Model requests and cache → Promo judging: returns trailer picks
README.md - Cut validation and repair → Promo judging: provides promo cuts
README.md - Promo judging → Model requests and cache: requests promo scores
README.md - Model requests and cache → Scoring and ranking: returns scores
README.md - Scoring and ranking → Promo result files: writes ranked outputs
README.md