Skip to content
Back to search

claude-youtube-editor

Record the talking head, Claude Code does the rest: the cut, the visuals, the voice, the sound effects, the thumbnail, and the YouTube upload. Every screen moment is built as Remotion TSX code, never screen-recorded.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hassancs91--claude-youtube-editor/badge.svg)](/listings/hassancs91--claude-youtube-editor)

HTML

<a href="/listings/hassancs91--claude-youtube-editor"><img src="/api/listings/hassancs91--claude-youtube-editor/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Requirements:** [Claude Code](https://claude.com/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**

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 166 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # claude-youtube-editor
  2. **Record the talking head. [Claude Code](https://claude.com/claude-code) does the rest.**
  3. An open-source pipeline that takes a raw recording all the way to a published YouTube video — the
  4. cut, the visuals, the voice, the sound effects, the thumbnail, and the upload. No video editor. No
  5. screen recording. Every screen moment you see is built as code ([Remotion](https://remotion.dev) TSX)
  6. and composited over your cut.
  7. > 📖 **Read the full walkthrough:**
  8. > [Edit a YouTube Video With Claude Code](https://learnwithhasan.com/guide/how-to-edit-videos-with-claude-code/?utm_source=github&utm_medium=readme&utm_campaign=claude-youtube-editor&utm_content=body)
  9. > The beginner setup, step by step, on my site. Free to read, no login.
  10. ## The six steps
  11. | # | Step | Skill | What happens |
  12. |---|---|---|---|
  13. | 1 | **The cut** | `/clean-cut` | AssemblyAI transcribes with tone + talking style, you author `cuts.json` from the transcript, out comes a clean master + word-level `edited-transcript.json` |
  14. | 2 | **The visuals** | `/make-tsx` · `/fake-screencast` | Remotion shots built over the master, every reveal synced to the word times. Generated UI clones that simulate a screen recording — nothing captured |
  15. | 3 | **The voice** | `/clean-audio` | diagnose the noise, isolate the voice, keep the levels |
  16. | 4 | **The sound** | `/suggest-sfx` | function-first SFX landing on the exact word, from a library that grows with every video |
  17. | 5 | **The packaging** | `/packaging` | one title × 3 thumbnail bets for YouTube's A/B test, rendered as real images |
  18. | 6 | **The upload** | `tools/yt_upload.py` | checks itself for ghost speech + A/V drift, then uploads as a private draft |
  19. Plus **`/brand-setup`** — makes all of it look like *your* channel, not the one it came from.
  20. And **`/vidtsx-2d-generator`** — the low-level rules that keep a Remotion shot from crashing.
  21. ## What you record vs what it builds
  22. **You record:** yourself, talking. That's the whole shot list.
  23. **It builds:** every full-screen statement, diagram, UI walkthrough, browser and terminal mockup,
  24. title card, and transition — as code, over your cut, synced to what you actually said.
  25. ## Quickstart
  26. **Requirements:** [Claude Code](https://claude.com/claude-code) · Python 3.10+ · Node 18+ ·
  27. `ffmpeg` + `ffprobe` on PATH.
  28. ```bash
  29. git clone https://github.com/hassancs91/claude-youtube-editor
  30. cd claude-youtube-editor
  31. python -m venv venv
  32. venv/Scripts/python -m pip install -r requirements.txt # Windows (./venv/bin/pip on macOS/Linux)
  33. cd remotion && npm install && npm run gen && cd .. # build the Remotion registry
  34. cp .env.example .env # add your keys
  35. claude # open in Claude Code, then:
  36. ```
  37. > **set up my brand** · **clean cut videos/video-1** · **add TSX beats to video-1** ·
  38. > **suggest sfx for video-1** · **package this video**
  39. ## See it before you shoot anything
  40. The repo ships **37 real shots** from a published video — the worked example of the kit. They render
  41. standalone, no footage needed:
  42. ```bash
  43. cd remotion && npm run studio
  44. ```
  45. That's the fastest way to see what this produces, and reading a few is the fastest way to learn
  46. `remotion/src/lib/` (the browser frame, the screencast engine, the VS Code shell, the motion kit).
  47. ## Make it yours
  48. The repo ships with a house brand — a calm, premium indigo look. It's real and you can keep it, but
  49. **if you change nothing, your videos will look like someone else's channel.**
  50. ```
  51. /brand-setup
  52. ```
  53. It interviews you, rewrites `brand.md` + `remotion/src/brand.ts` + `remotion/src/fonts.ts` together,
  54. checks your fonts exist and your palette is actually readable, and renders a proof card so you see
  55. your brand before you build a video in it.
  56. ## What it costs (the honest part)
  57. **This project is free and open source. The models are not.** You'll need:
  58. | Service | For | Notes |
  59. |---|---|---|
  60. | **Claude Code** | driving the whole thing | paid plan or API credits |
  61. | **AssemblyAI** | transcription (step 1) | free tier is enough to try it |
  62. | **ElevenLabs** | voice isolation + SFX + music (steps 3–4) | paid. `/clean-audio` also has a **local RNNoise** method that needs no key |
  63. | **Gemini** | thumbnails (step 5) | paid, and only if you render thumbnails |
  64. | **YouTube** | upload (step 6) | free, OAuth — see `tools/yt_upload_SETUP.md` |
  65. Nothing here is a subscription to me. These are your own keys, in your own `.env`.
  66. ## Roadmap
  67. Open source, and I'm keeping it updated:
  68. - [ ] **Transitions** — a proper transition library between beats
  69. - [ ] **Effects** — zoom/punch-in, highlight, spotlight passes
  70. - [ ] **Filters** — grade/look presets that respect the brand contract
  71. - [ ] A cuts.json time-remapper (so `edited-transcript.json` doesn't need a second transcription pass)
  72. ⭐ **Star the repo** if you want to see where it goes — that's genuinely how I decide what to build next.
  73. Issues and PRs welcome. Tell me which step you want to go deep on.
  74. ## What's NOT in here
  75. Being straight with you about the scope:
  76. - **No script writer.** This edits video; it doesn't write it.
  77. - **No footage.** The example's shots ship, its raw recording doesn't (`videos/` starts empty).
  78. - **No face kit.** Thumbnails need reference photos of *your* face in `media/library/faces/` — you
  79. supply those. See that folder's README.
  80. - **No CTR data.** `/packaging`'s rules ship, calibrated on a real channel's numbers; the numbers
  81. themselves don't. Once you have ~10 videos, `references/channel-calibration.md` walks you through
  82. building your own — and then your data beats the defaults.
  83. ## Repo layout
  84. ```
  85. .claude/skills/ the 8 skills (this is where the editor actually lives)
  86. tools/ Python: transcribe, cutlib, render_cuts, verify_cut, clean_voice, bake,
  87. gen_sfx/mix_sfx, gen_music/mix_music, gen_thumbnail, yt_stats, yt_upload,
  88. capture_web + the cut-editor UI (editor/) + rnnoise models
  89. remotion/ the Remotion project — shared kits in src/lib/, src/shots/<project>/ one folder
  90. per video; registry generated by `npm run gen`
  91. media/library/ reusable assets: SFX + music clips (catalogued, loudness-normalized), logos, faces
  92. media/projects/ media for one specific video — via staticFile()
  93. videos/ your videos. Empty until you make one.
  94. brand.md the style contract — make it yours
  95. ```
  96. ## Who made this
  97. I'm Hasan. I build things with AI and show how on
  98. [YouTube](https://youtube.com/@learnwithhasan) — this repo is how those videos get made.
  99. If you want to learn to build things like this yourself, that's what my course
  100. [Build With AI](https://learnwithhasan.com/courses/build-with-ai-10/?utm_source=github&utm_medium=readme&utm_campaign=claude-youtube-editor&utm_content=body) is for. It's not required for
  101. any of this — the repo is complete on its own, and always will be.
  102. ## License
  103. MIT — see [LICENSE](LICENSE). Bundled SFX/music clips were generated by the repo author (ElevenLabs)
  104. and are redistributed here; per-clip provenance is in `media/library/*/catalog.json`. Product logos
  105. (Claude, VS Code) are the property of their respective owners.
  106. <!-- lwh-footer -->
  107. ---
  108. ## 📘 The free book
  109. This repo is one thing I built with AI. The book is the system underneath it.
  110. **[Vibe Engineering Blocks](https://learnwithhasan.com/blocks/?utm_source=github&utm_medium=readme&utm_campaign=claude-youtube-editor&utm_content=footer)** is my free 74-page book.
  111. 47 building blocks for shipping real apps with AI. One block per page, each with the exact
  112. prompt to hand your AI.
  113. Built by **[Hasan Aboul Hasan](https://learnwithhasan.com/?utm_source=github&utm_medium=readme&utm_campaign=claude-youtube-editor&utm_content=footer)**. I build real products with AI and
  114. write down exactly how.
  115. [Guides](https://learnwithhasan.com/guides/?utm_source=github&utm_medium=readme&utm_campaign=claude-youtube-editor&utm_content=footer) &nbsp;·&nbsp;
  116. [YouTube](https://www.youtube.com/@HasanAboulHasan) &nbsp;·&nbsp;
  117. [Community](https://learnwithhasan.com/community/?utm_source=github&utm_medium=readme&utm_campaign=claude-youtube-editor&utm_content=footer)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.