mpv-clipper
is a Lua script for mpv that lets you quickly create clips from videos directly in the player.
It is lossless by default (using copy
mode), but also supports quality presets (high
, medium
, fast
, tiny
) and a custom
mode for advanced control.
You can cycle between presets with a single key (q
).
Windows
macOS / Linux
scripts/
folder inside your mpv config directory if it doesn't exist.mpv-clipper.lua
into the scripts/
folder.mpv-clipper.conf
file in the main mpv config directory to override settings.Final structure:
~/.config/mpv/
├── scripts/
│ └── mpv-clipper.lua
└── mpv-clipper.conf (optional)
3. Ensure FFmpeg Is Available
Make sure FFmpeg is installed and available in your system PATH
.
Test with:
mpv
c
to mark the startv
to mark the endb
to create the clipq
to cycle through:copy
→ high
→ medium
→ fast
→ tiny
→ custom
→ back to copy
copy
mode = lossless passthrough (no re-encoding).
Other presets re-encode with different CRF, preset speed, and audio bitrates.custom
mode uses only what you define in mpv-clipper.conf
.
c
Set start point v
Set end point b
Create clip q
Cycle quality mode
Create or edit mpv-clipper.conf
in your mpv config folder.
# Output directory for clips (leave empty for same folder as source) output_dir="/home/user/clips" # Default codecs ("copy" = lossless passthrough) video_codec="copy" audio_codec="copy" # Container format (auto=same as input) container="auto" # Audio bitrate (used if audio is re-encoded) audio_bitrate="192k" # Optional CRF & preset (only used if re-encoding video) crf="" preset="" # Optional scaling (e.g., "1280:-1") scale="" # Clip filename suffix clip_suffix="-clip" # OSD duration in ms osd_duration=1500 # Show debug logs in console show_logs=false # Default quality mode # Options: copy, high, medium, fast, tiny, custom quality="copy"Mode Video Codec CRF Preset Audio Codec Audio Bitrate copy copy — — copy — high libx264 18 slower aac 192k medium libx264 20 medium aac 128k fast libx264 23 fast aac 96k tiny libx264 28 ultrafast aac 64k custom user-set — — user-set — Example 1: Lossless Clip (default)
1. mpv video.mp4
2. Press `c` at 00:05:10
3. Press `v` at 00:06:30
4. Press `b` → Outputs lossless clip in same format as source
Example 2: Quick Re-encode
1. Press `q` until "medium" appears in OSD
2. Set start/end with `c` and `v`
3. Press `b` → Outputs re-encoded clip (CRF 20, medium preset, 128k audio)
mpv-clipper.lua
is in scripts/
~
to open console and check for [mpv-clipper]
messagesPATH
output_dir
mpv --input-test
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4