casting-call

Turn call recordings into transcripts that know who said what, and how they said it.

I record my calls with OBS into a single .mkv: my mic on one track, the far side (Chrome/Meet) on a second, in-call markers on a third, plus the Meet window on screen. This repo is everything that happens after the call ends. It started as "split the tracks and run Whisper" and has grown into three capabilities that cover each way a recording can be useful (or broken).

New here or coming back cold? Read the user guide in a browser. It is written to be read with zero prior knowledge, covers every command and constant, and has animated diagrams of the three core mechanisms.

The three capabilities

1. Transcribe (ripa). Separate the audio tracks, run whisper-cpp on each, merge by timestamp into [h:mm:ss] [You] / [Caller] lines. Every remote participant lands on the far-side track as one undifferentiated Caller.

2. Attribute speakers (rips). Meet's on-screen captions already say who is speaking. Sample the video, OCR the caption band, fuzzy-match names against your local roster, build a speaker timeline, and rewrite Caller lines with real names. Includes an interactive review step for names it will not guess at.

3. Recover from a dead channel (ripcap). When the far-end audio never made it to disk (it happens; ask me how I know, twice), the captions burned into the video are the words. The stitcher OCRs every caption frame and merges the rolling, overlapping text into one attributed transcript.

Commands

Alias	Script	Does
ripa	extract_audio_stereo.sh	extract + transcribe + auto-relabel if a timeline exists
rips	extract_speakers.sh	caption OCR → speaker timeline → relabel transcript
ripcap	stitch_captions.sh	captions → full transcript (dead-channel fallback)
ripv	convert_video.sh	re-encode to a smaller H.265 playable copy, audio mixed you=L / caller=R

The aliases live in my gutils shell config, not here. Every script works without them: bash bin/<script>.sh ... from the repo root.

Typical session

# ...record the call with OBS (multi-track: mic, far side, markers)...
ripa ~/calls/2026-07-06                            # transcribe everything in the folder
rips recording.mkv --region 120,1850,900,180 \
     --transcript transcripts/recording.txt        # put real names on the Caller lines

And when the far-side audio never made it to disk:

ripcap recording.mkv --region 120,1850,900,180     # words, from the captions

Setup

brew install tesseract ffmpeg whisper-cpp
pip install --break-system-packages pillow numpy pytesseract pytest

Whisper model (ripa defaults to ggml-large-v3.bin; the error message tells you which to fetch if it is missing):

mkdir -p ~/whisper-models
curl -o ~/whisper-models/ggml-large-v3.bin -L \
  'https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3.bin?download=true'

Roster (your real names stay local; the file is gitignored):

cp speakers_roster.example.json speakers_roster.json
# edit: set "self" to your name, list the people you call

Repo shape

bin/               shell entry points (thin; the logic lives in the package)
casting_call/      the Python package
  sample/locate/read/roster/timeline/transcript/review/coverage   speaker layer
  stitch.py        rolling-caption stitcher + CLI
  markers.py       Track 3 marker phrases folded into the transcript
  tests/           pytest suite (fast, no fixtures on disk)
docs/user-guide.html   the real documentation; start there

Everything runs locally. No accounts, no uploads, and anything the tool cannot confidently attribute stays labeled Caller rather than being guessed.