/mpv-cut

Cut videos incredibly quickly directly inside of the video player mpv. Fork of familyfriendlymikey/mpv-cut

Primary LanguageJavaScript

mpv-cut

preview

about

The core functionality of this script is to very quickly cut videos losslessly in mpv as an alternative to LosslessCut.

I decided to modify mpv-cut since I was looking for slightly different functionality to what the original script provided. Mainly I wanted to be able to adjust the start and end points of cuts.

Also credits to suckless-cut for inspiration & keybinds.

requirements

Besides mpv, you must have the following in your PATH:

  • ffmpeg
  • node

(I recommend using scoop to install both on Windows)

installation

Download the latest release and move the folders in the zip into your mpv folder.

Platform Path
Windows %appdata%/Roaming/mpv/
Windows (Scoop) %userprofile%/scoop/persist/mpv/portable_config/
Linux/MacOS ~/.config/mpv/scripts/

After that, the next time you run mpv the script will be loaded.

Note: mpv-cut should have its own folder inside your scripts folder. (scripts/mpv-cut/main.lua & make_cuts.js)

options

script-opts/mpv-cut.conf:

  • output_dir - The output directory for cuts, can be relative or absolute.
    • Default value: . (will place cuts in the same directory as the original video)
  • multi_cut_mode - The mode for handling multiple cuts for a single video. Options:
    • separate: create separate cut files (default)
    • merge: merge cut files into a single cut.

usage

keybinds

  • g and h to set the start and end points of a cut (will use your current position).
  • G and H will do the same, but will place the points at the very start or end of the video.
  • r to render cuts.

If you want to change the start or end position of a cut you can press the keybind again. You can also create multiple cuts from a single video.

Rendered cuts will be placed in the same directory as the source file.


troubleshooting

If the script doesn't work, you can try these steps.

  • Make sure all of the requirements are installed
  • Make sure the script is installed in the correct directory. You should end up with something like: C:\Users\admin\scoop\persist\mpv\portable_config\scripts\mpv-cut\main.lua & make_cuts.js.
  • Run mpv using the terminal (mpv video.mp4) and check the output, are there any errors?
  • Make sure you don't have multiple versions of mpv installed. You might have installed the script to the wrong version.