The One Clip to Rule Them All
A media processing CLI that wraps ffmpeg into ergonomic commands for cutting, compressing, transcribing, and editing video files.
Everything you need to process video from the command line.
Extract video segments by start and end timestamps. oneclip cut video.mkv --start 00:01:00 --end 00:05:00
H.264 compression with configurable quality and speed presets. Supports batch processing for multiple files. oneclip batch analyze shows size, duration, and compression status for a whole folder.
Generate SRT subtitles from video using whisper.cpp. Handles WAV conversion automatically.
Automatically detect and remove silent segments. Configurable threshold, duration, and minimum segment length.
Extract audio tracks to WAV format. Select or remove specific audio tracks from multi-track files.
Extract thumbnails using scene detection or fixed intervals. Generate styled YouTube thumbnails with text overlays.
Concatenate two or more video files into a single file. Fast stream copy with no re-encoding. oneclip join part1.mkv part2.mkv
Listens for OBS recordings and shows a native macOS dialog to rename the file when it stops. No terminal focus needed.
Simple commands that do the right thing by default.
# Cut a segment from a video $ oneclip cut video.mkv --start 00:01:00 --end 00:05:00 # Compress with high quality $ oneclip compress video.mkv --verygood --speed slow # Batch compress all MKV files $ oneclip compress *.mkv # Analyze folder for compression status $ oneclip batch analyze ./recordings # Auto-compress uncompressed files in a folder $ oneclip batch compress ./recordings # Generate subtitles $ oneclip transcript video.mkv # Remove silence from a recording $ oneclip silence-remove video.mkv --threshold -30dB # Extract thumbnails via scene detection $ oneclip thumbnail-frames video.mkv --count 5 # Generate a styled thumbnail from an image $ oneclip thumbnail screenshot.png --title "My Video" # Join multiple video files into one $ oneclip join part1.mkv part2.mkv part3.mkv # Watch OBS and rename recordings via macOS popup (macOS only) $ oneclip obs-renamer
All commands accept -o <file> to specify an output path. If omitted, outputs are named <input>_<timestamp>.<ext>.
Claude Code commands that automate your entire content creation workflow.
/video-pipelineFull production workflow in one command. Audio track selection, transcription, AI-generated titles, chapters, and descriptions, silence removal, thumbnails, and compression — all automated.
/video-describeFeed it an SRT transcript, get back YouTube-ready titles, thumbnail text, chapters, and tags. Turns your raw recording into publish-ready metadata.
These are Claude Code slash commands. Install OneClip, open Claude Code in your project, and run them.
Auto-rename OBS recordings when they finish — a native macOS dialog pops up so you can title the file without switching to the terminal.
# Connect to OBS WebSocket and listen for recordings $ oneclip obs-renamer Connected to OBS (localhost:4455) Watching for recordings... (Ctrl+C to quit) Recording started... Recording stopped: ~/Movies/2026-03-05_12-30-00.mkv Renamed: 2026-03-05_12-30-00.mkv → 2026-03-05_my-tutorial.mkv
# Install — runs on login, retries every 30s if OBS is closed $ oneclip obs-renamer --install # Check if running $ oneclip obs-renamer --status # Remove $ oneclip obs-renamer --uninstall
--install, --uninstall, and --status are macOS-only (launchd).
Requires macOS, Python 3, OBS Studio with WebSocket server enabled, and pip install -r obs/requirements.txt.
Up and running in under a minute.
Checks dependencies, then installs the CLI globally.
$ npx install-oneclip
$ npm install -g oneclip
$ git clone https://github.com/daymannovaes/the-one-clip.git $ cd the-one-clip $ npm install $ npm link # `oneclip` is now available globally
# Node.js 18+, ffmpeg and ffprobe required # macOS $ brew install ffmpeg # Ubuntu/Debian $ sudo apt install ffmpeg # Optional: whisper.cpp for transcription # See https://github.com/ggerganov/whisper.cpp