claude-youtube-editor

Record the talking head. Claude Code does the rest.

An open-source pipeline that takes a raw recording all the way to a published YouTube video — the
cut, the visuals, the voice, the sound effects, the thumbnail, and the upload. No video editor. No
screen recording. Every screen moment you see is built as code (Remotion TSX)
and composited over your cut.

📖 Read the full walkthrough:
Edit a YouTube Video With Claude Code
The beginner setup, step by step, on my site. Free to read, no login.

The six steps

Plus /brand-setup — makes all of it look like your channel, not the one it came from.
And /vidtsx-2d-generator — the low-level rules that keep a Remotion shot from crashing.

What you record vs what it builds

You record: yourself, talking. That's the whole shot list.

It builds: every full-screen statement, diagram, UI walkthrough, browser and terminal mockup,
title card, and transition — as code, over your cut, synced to what you actually said.

Quickstart

Requirements: Claude Code · Python 3.10+ · Node 18+ ·
ffmpeg + ffprobe on PATH.

git clone https://github.com/hassancs91/claude-youtube-editor
cd claude-youtube-editor

python -m venv venv
venv/Scripts/python -m pip install -r requirements.txt   # Windows (./venv/bin/pip on macOS/Linux)

cd remotion && npm install && npm run gen && cd ..       # build the Remotion registry

cp .env.example .env                                     # add your keys

claude                                                   # open in Claude Code, then:

set up my brand · clean cut videos/video-1 · add TSX beats to video-1 ·
suggest sfx for video-1 · package this video

See it before you shoot anything

The repo ships 37 real shots from a published video — the worked example of the kit. They render
standalone, no footage needed:

cd remotion && npm run studio

That's the fastest way to see what this produces, and reading a few is the fastest way to learn
remotion/src/lib/ (the browser frame, the screencast engine, the VS Code shell, the motion kit).

Make it yours

The repo ships with a house brand — a calm, premium indigo look. It's real and you can keep it, but
if you change nothing, your videos will look like someone else's channel.

/brand-setup

It interviews you, rewrites brand.md + remotion/src/brand.ts + remotion/src/fonts.ts together,
checks your fonts exist and your palette is actually readable, and renders a proof card so you see
your brand before you build a video in it.

What it costs (the honest part)

This project is free and open source. The models are not. You'll need:

Nothing here is a subscription to me. These are your own keys, in your own .env.

Roadmap

Open source, and I'm keeping it updated:

• Transitions — a proper transition library between beats
• Effects — zoom/punch-in, highlight, spotlight passes
• Filters — grade/look presets that respect the brand contract
• A cuts.json time-remapper (so edited-transcript.json doesn't need a second transcription pass)

⭐ Star the repo if you want to see where it goes — that's genuinely how I decide what to build next.
Issues and PRs welcome. Tell me which step you want to go deep on.

What's NOT in here

Being straight with you about the scope:

• No script writer. This edits video; it doesn't write it.
• No footage. The example's shots ship, its raw recording doesn't (videos/ starts empty).
• No face kit. Thumbnails need reference photos of your face in media/library/faces/ — you
  supply those. See that folder's README.
• No CTR data. /packaging's rules ship, calibrated on a real channel's numbers; the numbers
  themselves don't. Once you have ~10 videos, references/channel-calibration.md walks you through
  building your own — and then your data beats the defaults.

Repo layout

.claude/skills/   the 8 skills (this is where the editor actually lives)
tools/            Python: transcribe, cutlib, render_cuts, verify_cut, clean_voice, bake,
                  gen_sfx/mix_sfx, gen_music/mix_music, gen_thumbnail, yt_stats, yt_upload,
                  capture_web + the cut-editor UI (editor/) + rnnoise models
remotion/         the Remotion project — shared kits in src/lib/, src/shots/<project>/ one folder
                  per video; registry generated by `npm run gen`
media/library/    reusable assets: SFX + music clips (catalogued, loudness-normalized), logos, faces
media/projects/   media for one specific video — via staticFile()
videos/           your videos. Empty until you make one.
brand.md          the style contract — make it yours

Who made this

I'm Hasan. I build things with AI and show how on
YouTube — this repo is how those videos get made.

If you want to learn to build things like this yourself, that's what my course
Build With AI is for. It's not required for
any of this — the repo is complete on its own, and always will be.

License

MIT — see LICENSE. Bundled SFX/music clips were generated by the repo author (ElevenLabs)
and are redistributed here; per-clip provenance is in media/library/*/catalog.json. Product logos
(Claude, VS Code) are the property of their respective owners.

📘 The free book

This repo is one thing I built with AI. The book is the system underneath it.

Vibe Engineering Blocks is my free 74-page book.
47 building blocks for shipping real apps with AI. One block per page, each with the exact
prompt to hand your AI.

Built by Hasan Aboul Hasan. I build real products with AI and
write down exactly how.
Guides  · 
YouTube  · 
Community