git404hub

what is freecut fr?

moh4696/freecut — explained in plain English

Analysis updated 2026-05-18

60PythonAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

tl;dr

A free, open-source AI video editor controlled by chatting with Claude Code or Codex: drop raw footage in a folder, describe the edit, and get final.mp4 back with no paid API keys required.

vibe map

mindmap
  root((freecut))
    What it does
      Chat-driven editing
      Filler word removal
      Subtitle burning
      Color grading
    Transcription
      Whisper local free
      VibeVoice diarization
      ElevenLabs paid
    Pipeline
      Transcribe clips
      Pack to text
      LLM edits and approves
      Render and self-eval
    Setup
      Clone and uv sync
      Install ffmpeg
      No API key needed

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Edit a talking-head video by chatting with Claude Code to cut filler words, dead air, and bad takes automatically

VIBE 2

Produce a tutorial or launch video with subtitles, color grading, and smooth audio fades without touching a timeline editor

VIBE 3

Transcribe and edit interview footage with multiple speakers using a local GPU and VibeVoice diarization

VIBE 4

Set up a reusable AI video editing skill in Claude Code that persists project memory across sessions

what's the stack?

PythonffmpegWhisperClaude Codemlx-whisperfaster-whisper

how it stacks up fr

moh4696/freecut0xh4ku/manga-pdf-to-epubayyouboss0011/sherlockmaps
Stars606060
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/52/53/5
Audiencevibe codergeneraldata

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires ffmpeg installed on your system, multi-speaker diarization needs a CUDA GPU or a remote VibeVoice endpoint.

MIT license -- use, modify, and distribute freely including for commercial purposes, as long as you keep the copyright notice.

in plain english

freecut is a fork of an open-source project called video-use that lets you edit video files by chatting with an AI coding assistant like Claude Code or Codex. The original project required a paid ElevenLabs speech transcription API key. freecut removes that requirement by replacing the transcription layer with free alternatives that run locally on your machine. The editing process works like this: you point the tool at a folder of raw video clips, open your AI assistant in that folder, and describe what you want. The assistant reads the transcripts, builds an edit list, waits for your approval, then calls ffmpeg to produce a final video file called final.mp4. It never watches the actual video frames directly. Instead it reads a compact text transcript of every word spoken, with timestamps, so it can make precise cuts based on speech boundaries without processing thousands of video frames. The default transcription backend is Whisper, a free, open-source speech-to-text model from OpenAI that runs entirely on your own computer with no API key needed. For videos with multiple speakers, an optional backend called VibeVoice-ASR can identify who is talking when, but this requires a machine with an NVIDIA GPU and is not available on most Macs. The original ElevenLabs backend is still supported if you already have a key. Beyond cutting, freecut can remove filler words and dead air, apply color grading, add subtitles, and burn in animation overlays. After each render it checks its own output at every cut point before showing you the result, and it saves notes about your project so a later session can pick up where you left off. Installation takes a few minutes: clone the repo, install Python dependencies with uv or pip, install a Whisper package, and ensure ffmpeg is on your system. No API keys are required for the default local-Whisper setup.

prompts (copy fr)

prompt 1
Set up freecut in Claude Code for me: read install.md, install mlx-whisper on Apple Silicon, register the skill, and tell me when it's ready to accept footage
prompt 2
I have 10 raw talking-head clips in ~/Videos/launch/. Edit them into a 2-minute launch video, cut filler words and dead air, add 2-word uppercase subtitles, and output final.mp4
prompt 3
How does freecut represent a video transcript for the LLM and why does it use a text file instead of processing video frames?
prompt 4
I want multi-speaker diarization with freecut using VibeVoice. What do I need to set up and what endpoint format does the backend expect?
prompt 5
Explain freecut's self-eval loop: what does it check at each cut boundary before showing me the preview, and how many times will it retry a bad cut?

Frequently asked questions

what is freecut fr?

A free, open-source AI video editor controlled by chatting with Claude Code or Codex: drop raw footage in a folder, describe the edit, and get final.mp4 back with no paid API keys required.

What language is freecut written in?

Mainly Python. The stack also includes Python, ffmpeg, Whisper.

What license does freecut use?

MIT license -- use, modify, and distribute freely including for commercial purposes, as long as you keep the copyright notice.

How hard is freecut to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is freecut for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.