VanoPeradze/cutroom
VanoPeradze/cutroom has 34 GitHub stars and 5 forks. GitHot measured +1 stars in 24 hours. Last checked 2026-11-13 22:40 UTC. Last push 2026-11-07.
What you can do
- Six focused workspaces. Media, Edit, Layout, Audio, Captions and Output share one player and one timeline.
- Independent A/B tracks. Cut, trim and move a camera and a screen recording together or separately, with Undo/Redo and track locks. Timeline controls
- Camera and screen layouts. Stacked, side by side, picture in picture, camera only or screen only, for a selected range or the entire edit.
- Track mixer. Balance Original, Music, Voiceover, Effects and Master with live level meters. Mute applies to preview and export; Solo is for preview only.
Measured star growth
- in 24h
- +1
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Free, local-first video editing for creators. AI-assisted drafts, independent timelines, captions and manual control. Windows and Mac beta.
Creative & MediaREADME.md
Original
A free, local-first video editor for YouTube, Shorts and Reels.
Cut your recording, frame every shot, mix the sound and add captions.
Start by hand, or let optional AI draft a first cut that you review and change.
Website · Windows releases · Mac releases · User guide · Hebrew README
Click any image to open that exact file at full size. The Home and editor cards use unaltered demo screenshots from 19 October 2026; original PNGs are linked below each card. These are interface previews, not a capture of the latest release or a demonstration of AI editing quality. Screenshot dates and coverage · Artwork and provenance
Contents
1.3 Beta update · Highlights · Quick start · How it works · AI, your way · Privacy · Requirements · Beta status · Documentation · Contributing and support · License and credits
1.3 Beta update
CUTROOM 1.3 Beta gives added videos their detected source sound by default, with mute and gain controls. Existing silent overlays keep their saved choice. The AI draft notice expands in the inspector, leaving the preview clear. Compact layouts, preview recovery and FFmpeg compatibility are improved. See the changelog for source-review and timeline updates; each release identifies its exact source and recorded checks.
Highlights
- Six focused workspaces. Media, Edit, Layout, Audio, Captions and Output share one player and one timeline.
- Independent A/B tracks. Cut, trim and move a camera and a screen recording together or separately, with Undo/Redo and track locks. Timeline controls
- Camera and screen layouts. Stacked, side by side, picture in picture, camera only or screen only, for a selected range or the entire edit.
- Track mixer. Balance Original, Music, Voiceover, Effects and Master with live level meters. Mute applies to preview and export; Solo is for preview only.
- Text and captions. Add titles and captions, import SRT or VTT, and correct and style an optional AI transcript.
- Green screen and stabilization. Apply a chroma key to any video source, or create an optional stabilized local copy. Green screen · Stabilization
- Local MP4 export. Landscape, vertical, square, portrait or the source shape, from 720p to 4K at up to 60 FPS, with no CUTROOM watermark.
- Gameplay vision for Shorts. A compatible installed local Story model looks at sampled frames to propose action moments and filter menus and loading screens. Frames stay on your computer. Models
- AI is optional. Manual editing needs no AI model, API key or account.
![]() |
![]() |
| Home · Original PNG | Media · Original PNG |
![]() |
![]() |
| Edit · Original PNG | Layout · Original PNG |
![]() |
![]() |
| Audio · Original PNG | Captions · Original PNG |
![]() |
![]() |
| Output · Original PNG | AI connection · Original PNG |
![]() |
![]() |
| Projects · 15 October 2026 | Export confirmation · 15 October 2026 |
These ten views are the authentic captures currently available; the AI capture date is unrecorded. The full window checklist identifies dialogs and states still awaiting fresh screenshots.
Quick start
Download for Windows or macOS
| Platform | Download | Launcher |
|---|---|---|
| Windows | Windows releases | START CUTROOM.bat |
| macOS | Mac releases | START CUTROOM.command |
- Extract the entire ZIP into a fresh folder. Keep App, START HERE.html and the launcher together.
- Open the launcher beside App and let setup finish. In a combined ZIP, open windows or mac first.
- Edit in your browser. Keep the launch window open while you work; closing the browser alone does not stop CUTROOM.
These are source-based beta packages. First setup needs internet. Python, FFmpeg, the local Story engine and AI models are not bundled. If the browser does not open, use the address shown in the launch window. The Mac launcher is unsigned; the platform guide explains setup and security prompts.
[!IMPORTANT] Before the first Windows launch, make sure WinGet is available and install the official Microsoft Visual C++ x64 runtime. The CUTROOM launcher does not install this prerequisite.
The releases page includes source identities, recorded checks and SHA-256 sidecars. Downloads can differ from the current repository. To update, extract a fresh copy separately and back up projects before moving them. The 18 October beta remains available for rollback.
Run from source
- Windows: run
run_windows.batfrom the repository root. - macOS: follow the Mac setup guide.
- Linux: install Python 3.12 with
venvandpip, FFmpeg/FFprobe and Bash, then run:
chmod +x setup_linux.sh run_linux.sh
bash setup_linux.sh
bash run_linux.sh
Setup creates a local virtual environment and installs the Python dependencies. FFmpeg needs the encoding and subtitle filters listed in the Linux prerequisites.
How it works
- Bring your footage. Start with one recording, or add a camera and a screen recording as sources A and B.
- Build your edit. Edit by hand, or review an AI-assisted YouTube cleanup or Short/Reel draft.
- Make it yours. Trim and arrange clips, adjust framing and sound, add captions, then export an MP4 and watch the result.
The library stays on the left, the preview in the centre, properties on the right and the timeline below. Select a clip or caption to open its tools. Imported audio has per-clip volume and fades; Audio controls whole mixer groups. Drag a divider, or focus it and use the arrow keys, to resize the workspace.
| Workspace | What you do there |
|---|---|
| Media | Import recordings, images, music and voiceover. Search and filter the project library. Your original files stay untouched. |
| Edit | Split, trim, move and restore clips. Protect a track with a lock. Apply a green screen in Effects. |
| Layout | Choose the composition, assign camera and screen roles, set the framing and adjust the sync offset. |
| Audio | Mix Original, Music, Voiceover, Effects and Master with live meters, Mute and Solo. |
| Captions | Add text and captions, import SRT or VTT, correct the transcript and style the subtitles. |
| Output | Choose the shape, resolution, frame rate and quality, then export. |
User guide · Keyboard shortcuts · Shortcut profiles
AI, your way
| Mode | What it does | What it needs |
|---|---|---|
| Manual editing | You make the cuts, add media and captions, and export. | No AI model, API key or account. |
| Local AI | Transcribes speech and proposes an edit using models on your computer. | Separate model downloads, disk space and processing time. Story AI needs a separate local engine. |
| Cloud AI (optional) | Uses Groq or a compatible provider for transcription and edit planning. | Your own API account, compatible models and your explicit consent. Provider limits and billing apply. |
- You stay in control. A new AI draft does not replace your manual timeline until you choose Apply new AI draft, and Undo stays available.
- Plan for model downloads. Auto mode uses stronger transcription and Story models when already installed and supported by available GPU memory. A missing selected speech model can download on first use. Download behavior
- Know your limits. Mac transcription currently runs on the CPU. A chat subscription does not include API access, and free tiers have usage limits.
AI connections and privacy · Models and download sizes
Privacy
- Local work. Editing, preview and MP4 export run on your computer. Projects and working media are stored locally.
- Cloud AI only with consent. When cloud AI is enabled, selected audio is sent to your provider for transcription, and transcript text and editing context for planning. Video frames are not sent. The provider's retention and privacy terms apply.
- No CUTROOM account. There is no CUTROOM subscription, account or export watermark.
Requirements
| Platform | Status |
|---|---|
| Windows | Source-based beta ZIP with launcher. WinGet and the Microsoft Visual C++ x64 runtime are prerequisites; see Quick start. Physical-device coverage remains pending. |
| macOS | Source-based Mac beta ZIP for macOS 15 or later on Apple Silicon and Intel. Finder, Gatekeeper and Safari behavior still need manual verification; see the dated release for automated checks. |
| Linux | Source checkout only: Python 3.12, FFmpeg/FFprobe and Bash. No Linux download, and the full Linux installation is not yet verified end to end. |
See the platform guide for exact prerequisites, commands and troubleshooting.
Beta status
CUTROOM 1.3 Beta is beta software. Start with a short recording, keep your originals, and review captions, AI selections, synchronization, sound and the exported MP4 before publishing. AI drafts need your review; the default YouTube cleanup keeps your recording's order.
With two recordings, confirm that both sources show the same moment. A camera appears only where its track has footage. Added media and custom text do not generally follow source reordering; Together → Close gaps moves them with the edit. Saved transcript-caption corrections follow surviving source speech. See timeline controls and limits.
Automated checks and synthetic renders do not prove real-footage quality or installation on every computer. Exact package checks belong to each dated release; physical-device setup, Mac security prompts and representative English/Hebrew editing remain in the manual acceptance protocol.
Beta status · Known limits · Mac validation · Changelog
Documentation
| Guide | Covers |
|---|---|
| User guide · Hebrew user guide | The complete editing workflow |
| Platform setup | Windows, macOS and Linux installation and troubleshooting |
| AI connections · Models | Local and cloud AI, privacy, model sizes |
| Timeline controls | Working with sources A and B |
| Green screen · Stabilization | Effects and their limits |
| Keyboard shortcuts | Commands and shortcut profiles |
| Test on another PC | First-run checks and common setup problems |
| All guides | The full documentation index |
Contributing and support
- Found a problem? Open an issue with your operating system, browser, steps to reproduce and a short, redacted error message. The tester feedback guide explains what helps most.
- Want to contribute? Start with development setup and checks and the contribution guidelines. CUTROOM is built with Python, plain JavaScript and FFmpeg.
- Security issue? Please follow the private process in the security policy instead of opening a public issue.
License and credits
CUTROOM is released under the MIT License. Third-party tools and AI models keep their own licenses; see the third-party notices.
Thanks to the open-source projects behind CUTROOM, including FFmpeg, faster-whisper, ivrit.ai and the local Story engine listed in the third-party notices. CUTROOM is independent of external AI providers.
Explore related projects
ytdl-org/youtube-dl
Command-line program to download videos from YouTube.com and other video sites
141,556 starsexcalidraw/excalidraw
Virtual whiteboard for sketching hand-drawn like diagrams
135,641 starsgodotengine/godot
Godot Engine – Multi-platform 2D and 3D game engine
120,103 starsmrdoob/three.js
JavaScript 3D Library.
118,320 stars









