Skip to content
github-actions[bot] edited this page Nov 22, 2026 · 14 revisions

Clippa: long Kick streams in, reviewed YouTube videos out

Clippa turns long Kick streams into YouTube uploads: full-length segments, topic compilations, Shorts, titles, descriptions, chapters and thumbnails, with a person approving every one before it goes out. Everything is a clippa <stage> command, and the always-on pieces (the recorder, the worker, serve and the Discord bot) run it unattended. (The app was called clipper: the old command still works, and the config files, CLIPPER_* settings and containers keep that name until the rename's deploy step, Configuration.)

Tip

New here? Start with Getting started: install a machine, run one stream end to end, and know where to look when something breaks. Want the tour first? The Overview covers what Clippa does, how it is built and what it has done so far.

flowchart TB
  subgraph find ["1. Find the moments"]
    direction LR
    rec["fetch / record"] --> sig["signals"] --> tr["transcribe"] --> sc["score"] --> seg["segments"]
  end
  subgraph make ["2. Make the videos"]
    direction LR
    fa["faces"] --> cut["cut"] --> me["meta"] --> th["thumbs"] --> sh["shorts"]
  end
  subgraph ship ["3. Ship"]
    direction LR
    rv{{"review<br/>Kitsu · Discord · war room"}} -->|approved| sch["schedule"] --> up["upload to YouTube"]
    rv -. "note" .-> rt["retake<br/>re-cut or re-cover, back to review"]
  end
  find --> make --> ship
Loading

Run it

Getting started
Roles and services
Configuration
Pipeline
Review · Reviewing · War room
Scheduling and uploads
Costs · Checkup

Install

Install (clippa setup)
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 and one-offs
Speakers · Faces
Covers · Cast library · B-roll · Clip art
Weekly issue
X posts · TikTok
News watcher
Character pieces

Research

Archives: other channels' back catalogs, searchable
People: one record per person, their names and channels
Receipts · Investigations
Search swarm · Story dossiers

Working on Clippa

Developing: layout, code shape, checks, and how these pages are built
How the processes talk: locks, heartbeats, the outbox, serve's API, which log to read

Something broke?

clippa doctor prints a fix for each problem; the bot DMs you; clippa checkup finds what never raised an error; logs are in logs/ (more)

Clone this wiki locally