Repository navigation
Getting started
Tip
Try anything risky on a short test stream first: fetch any short VOD and run it end to end.
From the clipper folder on a new machine (keep the folder path short on Windows, e.g. C:\clipper):
powershell -ExecutionPolicy Bypass -File deploy\bootstrap.ps1 # macOS/Linux: bash deploy/bootstrap.shIt installs uv, Python 3.12 and ffmpeg if they're missing, puts clippa and clipper commands on
PATH (the same program under its new and old name; open a new terminal to use them), then runs clippa setup, a
walkthrough that asks whether this machine joins an existing install or starts a new one,
what it runs, where it transcribes, its streams folder and encoder, and the keys (checked as
you enter them), then runs clippa doctor. Run it again to carry on; clippa setup --step keys redoes one step and clippa setup --check shows where each step stands.
Install has the full per-platform steps, including what setup doesn't do yet (Discord ids, YouTube sign-in, adding a show), the NAS recorder and running the worker and bot unattended.
clippa fetch <kick vod url>
clippa run <stream id>fetch keeps going past a video segment Kick no longer has (a gap beats no video) but says how
many it skipped and stores the count as skipped_fragments in the stream's meta.json: clips
over a gap jump there. A download that fails part way resumes on the next fetch and keeps the
count of the segments it skipped before (in source.ts.skipped until it finishes).
Each stage skips what's done; clippa run <id> --from cut redoes from a stage on
(Pipeline). Review the items in the war room or on the Discord cards
(Review); clippa serve schedules approved ones and uploads every [youtube] auto_upload_minutes (clippa schedule, clippa upload by hand when that's 0; see
Scheduling and uploads).
clippa status is the one screen. It opens with needs you: streams with items waiting
on a decision or held, and Checkup's findings on the services, stuck or failed runs,
late releases and sign-ins that are gone or expiring. Below that: the services' heartbeats and the recorder, each recent
recording's show, date and stages, review counts, the next releases and the month's spend.
Streams older than a week with nothing waiting are left out (--all lists them); --json
prints the same as data. Behind it:
clippa doctor --role gpu|serve|bot|nas (this machine's setup), clippa worker --status,
clippa review status (decisions and what's scheduled) and clippa costs (Costs).
clippa serve, the bot and the worker run as containers on the NAS:
clippa services status|stop|restart serve|bot|worker runs docker compose there, and code
changes go out with bash deploy/hub/deploy.sh (Roles and services,
NAS hub). Serve and the bot run unattended only through compose (deploy/hub, any
Docker host); only a GPU worker on Windows can be a scheduled task instead
(deploy\worker\worker-task.ps1, which clippa services drives when [serve] hub is unset). The recorder is its own container on the NAS:
bash deploy/record/deploy.sh, only when no show is live (a restart starts a new recording part).
The bot DMs you ([notify], see Review); logs are in logs/ (serve.log,
bot.log, worker.log); clippa doctor prints a fix for each problem it finds. clippa checkup finds the quiet ones: a stuck stage, a service that stopped, a late upload
(Checkup).
clippa -h lists the commands by group; clippa <command> -h gives each one's flags, every
one explained. A flag means the same thing wherever it appears: --items s02,c03 picks items
(the old --ids, --keys, --item and --segments still work), times are H:MM:SS, H:MM
or seconds, --dry-run changes nothing and says what would happen, --force redoes what is
already done, and --no-sync skips the Kitsu read. Two are command-specific: --from is a
stage on run and story run but a time on pick and preshow fetch, and --limit N caps
only upload and the archive and investigate commands.
Flags for different jobs on one command (upload --links and --next, say) are refused together.
A stream argument takes the id (kick-137022368), a stream folder, or a shortcut: latest is
the stream that started last (a recording still going has no start yet and is skipped),
latest:kino that show's, and any unique start of an id works (kick-13702); a mistyped id
names the nearest ones. The read commands take --json for a script or the Claude container:
review list, schedule --list, shows, costs, config diff, checkup.
Tab completion: clippa completion powershell (or bash) prints a script for the shell,
made from this version's commands, actions and flags; stream arguments complete to latest
and latest:<show>. Write it to a file once and load that from your profile, and make it
again after an update that adds commands:
clipper completion powershell > ~/clipper-completion.ps1
Add-Content $PROFILE '. ~/clipper-completion.ps1'(bash: clippa completion bash > ~/.clipper-completion.bash and source it from ~/.bashrc.)
A long clippa run logs "stage 4 of 15" as each stage starts.
Home · Getting started · clippa doctor · These pages are built from docs/wiki/ in the repo, so edits made here are overwritten: how to edit them
Run it
- Overview
- Getting started
- Roles and services
- Configuration
- Pipeline
- Review
- Reviewing
- War room
- Clippa messenger
- Scheduling and uploads
- Costs
- Checkup
- Audit
- Backups
Install
- Install
- Install checklist
- Kitsu
- Discord app
- YouTube sign-in
- Windows
- macOS
- Transcribe on Modal
- NAS recorder
- NAS hub
- Claude on the NAS
- Phone access
- Model providers
- Adding a show
- YouTube channel
Features
- Pre-shows
- Fetching VODs
- Speakers
- Faces
- Covers
- Cast library
- B-roll
- Clip art
- Weekly issue
- X posts
- TikTok
- News watcher
- Character pieces
- Documentaries
Research
Working on Clippa