justcaptionslisted
Install: claude install-skill SpaceSheepBoy/justcaptions-skill
# Just Captions
Everything runs through one script in this skill's folder: `scripts/jc.py`.
Needs `ffmpeg` and Python 3.9+ with Pillow (`pip install Pillow`).
## Transcription engine
- API key found (`JUSTCAPTIONS_API_KEY`, else `~/.config/justcaptions/api_key`) → Just Captions API: best accuracy, and needed for `--correct`, `--translate` and AI emoji picks.
- Otherwise → local `faster-whisper` (`pip install faster-whisper`; `--model small` default, `base` is faster, `large-v3` is best).
- Neither → the script says so. Ask the user which they want; don't install packages without asking.
**No key, but the user wants an API feature:** use the [account console](https://justcaptions.com/api/account/) to verify email and create a scoped API key. Set `JUSTCAPTIONS_API_KEY` in the local environment. Keep the key out of prompts and logs.
The monthly free allowance is 30 audio minutes and 50,000 caption characters. Excess usage draws on prepaid credits ($0.01 per audio minute or per 1,000 caption characters). View current usage and the balance in the account console.
If the API refuses because of the free allowance, the free-tier capacity or a spend cap, the script says why. When
faster-whisper is installed, it transcribes locally instead. Pass the message and the account link on to the user.
## Commands
```bash
python3 scripts/jc.py talk.mp4 --burn # captions burned in, default yellow box
python3 scripts/jc.py talk.mp4 --style emoji --burn # 3 big