https://github.com/speyll/mpv-scut

Explore mpv-scut, a versatile script designed for mpv users, enabling seamless video segmentation and merging. Easily define video segments and effortlessly merge them into a single, polished file, all without the need for reencoding. 🎬
https://github.com/speyll/mpv-scut

ffmpeg ffmpeg-script lua mpv mpv-config mpv-script mpv-scripts scripts

Last synced: 10 months ago
JSON representation

Explore mpv-scut, a versatile script designed for mpv users, enabling seamless video segmentation and merging. Easily define video segments and effortlessly merge them into a single, polished file, all without the need for reencoding. 🎬

• Host: GitHub
• URL: https://github.com/speyll/mpv-scut
• Owner: Speyll
• License: mit
• Created: 2023-08-30T13:39:09.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-07-30T06:38:08.000Z (over 1 year ago)
• Last Synced: 2025-03-26T10:21:31.954Z (10 months ago)
• Topics: ffmpeg, ffmpeg-script, lua, mpv, mpv-config, mpv-script, mpv-scripts, scripts
• Language: Lua
• Homepage:
• Size: 7.81 KB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
Explore the power of `mpv-scut`, a script tailored for [mpv](https://mpv.io/) enthusiasts. Effortlessly define segments within your videos and seamlessly merge them into a polished, singular file – all without the need for reencoding, thanks to the combined strength of mpv and FFmpeg.

## Key Features

- Quickly set start and end points to define video segments.

- Save segment points to a text file for later use.

- Retry processing using saved segment points in case of failure.

- Merge segments into a single, polished video without reencoding.

- Utilize FFmpeg's efficiency for high-quality video processing.

- Enjoy intuitive key bindings for a user-friendly experience.

## Usage Guidelines

1. Make sure you have [mpv](https://mpv.io/) and [FFmpeg](https://ffmpeg.org/) installed on your system.

2. Download the `mpv-scut.lua` script and save it in your `scripts` directory. You can locate the `scripts` directory by running `mpv --list-scripts` or make it yourself.

3. Open a video using `mpv`.

4. Use the following key bindings to control the script:

   - Press `c` to set the starting point of a segment.

   - Press `x` to set the ending point of the current segment.

   - Press `s` to save the segments to a text file.

   - Press `z` to process and merge segments.

   - Press `r` to retry processing using saved segment points from txt file.

5. The merged video, without reencoding, will be saved as `merged_video.mp4` in the original video's directory.

**Please Note:** This script relies on the `osd_message` function in mpv, so ensure OSD messages are enabled in your mpv settings.