Skip to content
kvrancicPublic

About

Any stream in, the clips worth posting out. A Claude Code plugin that cuts long videos into captioned 9:16 clips, edits whole talks and makes narrated videos, locally on your Mac.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

9 stars

Watchers

0 watching

Forks

Repository files navigation

cutroom

Any stream in. The clips worth posting out.
Your coding agent becomes a video editor, on your own Mac.

Hand Claude Code a 34-minute GTA VI stream and it reads every word, finds the moments worth posting, cuts them on word boundaries, stacks the streamer's face above the game and burns in big word-timed captions: three clips ready for TikTok, Reels and Shorts, each with its titles and cover.

license: MIT macOS: Apple Silicon Claude Code: plugin clips: 1080x1920 at 60 fps runs: on your Mac

Left: a 34-minute GTA VI stream with the player's face cam scrubs from 0:00 to 34:31. Right: the three vertical clips cutroom cut from it play side by side, the face above the game, a white title line on top and big captions on the seam.

Made by cutroom itself from 34 minutes of xChaseMoney2's GTA VI walkthrough (CC BY 3.0). Watch the demo as video · how it was made

⭐ Help more people find cutroom: star this repository.

Install · First run · What it makes · What makes a clip hold · How it is built

Install

claude plugin marketplace add kvrancic/cutroom
claude plugin install cutroom@cutroom

Two lines in your terminal. The first time you use it, Claude Code checks the Mac with cutroom doctor, says what is missing and offers cutroom setup, which fetches the speech and face models and the renderer into ~/.cutroom (about 2.6 GB, once). After that every clip is made on your Mac, with no account, no upload and no charge per minute.

Installed it as oneshot-video? The plugin moves to its new name by itself.

First run

Paste this into Claude Code with a recording of your own:

Make clips with cutroom: ~/Movies/stream.mp4 is a GTA VI stream with my face cam in the corner.
Find the three best moments for TikTok and YouTube Shorts, 15 to 40 seconds each,
with my face above the game and big captions. Ask me nothing you can decide yourself,
then open the review page.

It writes the brief, transcribes the whole stream, marks its loudest seconds, reads every word around them, gates each candidate for a head a stranger can follow and a tail that lands, renders the three clips and opens a page with all of them side by side. It never posts anything: you do.

What it makes

Job You give it You get back
Cut a long recording: a stream, a lecture, a talk, a podcast, an interview short clips that stand alone, each with a real head and tail, reframed to 9:16 by a camera that follows the face, with captions, graphics, B-roll, three titles, a cover and post copy for each platform
Edit everything recorded at one event: cameras, a microphone, a screen recording the whole talk as one finished video: synced, fillers and dead air out, the best angle on every sentence, a matched grade, an opening title, chapters and subtitles, handed back to Premiere Pro or Final Cut Pro
Make a script or a brief, with a logo, a song or a few clips a narrated story or a music-led promo: B-roll found and credited, titles, a voice with the time of every word, a bed cut on the bar

Every job starts from who will watch. cutroom brief writes down the viewer and the place, then picks one of six profiles (stream, talk, ad, story, promo, lecture). The profile sets the length, the opening, the layout, the pace, the captions, the B-roll, the sound and the loudness. Every default is a row of one table and every video is one plan, a JSON file the agent edits, so a re-cut changes the plan and renders only what changed.

What makes a clip hold

The rules a stream clip is held to, each a number in cutroom/profiles.py with its source beside it in references/:

  • The reaction comes first. A stream clip opens cold on the scream, the laugh or the line, then plays the setup. Nobody waits for context.
  • One line on the first frame says what the footage does not: who this is and what is at stake. It counts as the poster's own addition, which the platforms ask for before they show a repost to strangers.
  • The face above the game, cropped from the original's own pixels and never enlarged past twice, with the captions on the seam between them.
  • Captions one to three words a page, 72 px or larger, timed again on the finished sound so every word lands on its frame, kept clear of the top 14 percent and the bottom 35 percent where the apps draw their buttons.
  • No dead air. Pauses over half a second are cut, the sound never drops out at a cut and the mix lands at -14 LUFS with its peaks held.
  • 15 to 40 seconds, or whatever the campaign's brief asks for.

Two reports check every render line by line before you see it: one for the opening, one for every cut.

Other ways to install

Homebrew, for every user of the Mac
brew install hydra-hq/tap/cutroom
cutroom doctor

The formula puts the source in Homebrew's folder and cutroom on the PATH, then runs cutroom setup --prefix $(brew --prefix)/var/cutroom, which fills that folder with the Python environment, the models and Remotion, so every user of the Mac shares one copy. Run that line again if the install's last step did not finish. Any cutroom command links the skill into that user's Claude Code.

A clone, for Codex, Cursor, Gemini CLI or to work on it
git clone https://github.com/kvrancic/cutroom && cd cutroom
brew install python@3.12 ffmpeg whisper-cpp node
cli/cutroom setup        # fills ~/.cutroom and links this folder to it
cli/cutroom doctor       # ok, warn or MISS for each part, with the command that fixes it

Put cli/ on your PATH to type cutroom. For Codex, Cursor and other agents that read ~/.agents/skills, link the clone there as cutroom; the repository carries manifests for Codex, Cursor and Gemini CLI too. npx skills add kvrancic/cutroom installs the skill for the agents that tool knows.

Keys are optional. Pexels, Pixabay and Coverr bring more stock footage; ElevenLabs brings a narrator, made music beds and made sound effects. cutroom reads each key from the environment or from ~/.config/cutroom/keys.env. Without a key the verb that needs it says which key and where to get it, while everything else runs: stock then comes from Wikimedia Commons, NASA, the Internet Archive and Openverse. A narration is drafted in the Mac's own voice.

Requirements and speed

macOS on Apple Silicon, Homebrew, Python 3.12, Node 20 or later, about 2.6 GB for the models and the renderer and 5 GB free while rendering.

The demo above took one Claude Code session 63 minutes from the 34-minute recording to three packaged clips, on an M3 Pro shared with other work: transcription runs at about 12 times real time and a 30-second clip renders in a few minutes.

How it is built

  • SKILL.md: the one page an agent reads first. workflows/: one page for each job. references/: the craft, each number with its source.
  • cli/cutroom: the command. cutroom --help lists its verbs; each reports the files it wrote and its warnings (--json for one object) and exits 0 done, 1 failed, 2 a wrong call, 3 a missing key, 4 a check that warns.
  • cutroom/: the Python package. cutroom/profiles.py holds every number, cutroom/plan.py the plan's schema.
  • renderer/: the Remotion project that draws captions, layouts and graphics.
  • tests/: the suite, on a 40-second Creative Commons talk and a 20-second stream built from an open-source game and the same talk (tests/fixtures/CREDITS.md). Run .venv/bin/python -m unittest discover -s tests -t . from the top.
  • docs/research/: the four research reports the tool rests on.

Everything runs on the Mac: Whisper large-v3-turbo and Parakeet for the words and their times, YuNet for faces, ffmpeg and OpenCV for the camera, Apple Vision for the person matte and Remotion for captions and graphics. The network is used only for what you ask for: stock footage, a replay graph, ElevenLabs.

The demo

The three clips are cutroom's own work, made by one Claude Code session that was given only this repository's pages and the recording: 34.5 minutes (1:12:19 to 1:46:50) of "Can GTA 6 REALLY live up to the hype? | Ep. 1" by xChaseMoney2, published under the Creative Commons Attribution licence (CC BY 3.0). The session chose the moments from the loud seconds, cut them under the stream profile and checked them with both reports; no line of either failed. Grand Theft Auto VI is a game by Rockstar Games.

Unofficial. Not affiliated with Rockstar Games, Take-Two Interactive or Anthropic.

Contributing

Bug reports, ideas and clips you made are welcome as issues. cutroom report DIR --title "..." writes a bug report with your private paths taken out. AGENTS.md is the page for an agent that changes cutroom.

Licence

MIT. The fonts (Inter, Instrument Serif, Geist Mono) are under the SIL Open Font License. Remotion is free for individuals and companies of up to three people; larger companies need a Remotion company licence to render with it.

Built on whisper.cpp, Parakeet TDT through onnx-asr, Silero VAD, YuNet, the RNNoise models, FFmpeg and Remotion.

About

Any stream in, the clips worth posting out. A Claude Code plugin that cuts long videos into captioned 9:16 clips, edits whole talks and makes narrated videos, locally on your Mac.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

9 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages