Awesome

✂️ trim.lua

mpv script to create a "precise" clip of audio / video files without transcoding.

Overview

Differences from the other similar scripts

trim.lua is aimed only for extraction of clips with no-transcoding. Encodings will never be occured.
Without encoding, video trimming becomes tricky.
- A point you can specify to trim is limited to keyframes.
- Tested several softwares on macOS and as far as I know there is no software that can do it accurately. Well, there is, but none were perfect nor lightweight.
- This script is to achieve accuracy as much as possible — Making a clip from a file within minimum keyframe distance, without transcoding.

In short, trim.lua turns mpv into a simple lossless audio / video editor.

Install

curl https://raw.githubusercontent.com/aerobounce/trim.lua/master/trim.lua >> ~/.config/mpv/scripts/trim.lua

Requirements

ffmpeg

If your shell has PATH to ffmpeg you're ready to use.
- If not, rewrite ffmpeg_bin accordingly.
All Windows users likely have to specify full path to ffmpeg.
- Or copy the standalone binary into the script directory (not tested).

-- trim.lua

-- macOS, *nix
ffmpeg_bin = "ffmpeg"

-- Windows
ffmpeg_bin = "ffmpeg.exe"

Usage

Enable trim mode

<kbd>h</kbd> or <kbd>k</kbd>

If initialized with <kbd>h</kbd>, default trim positions will be: Current time position to End of file.<br> If initialized with <kbd>k</kbd>, default trim positions will be: Head of file to Current time position.

Toggle strip metadata mode (After initializing trim mode)

Stripping metadata can fix certain corrupted files.

<kbd>t</kbd>

Save Trim Positions

To write out a clip, press either of the keys twice with the same start / end position.<br> To quit Trim Mode, close mpv instance.

<kbd>h</kbd> Save Trim Start Keyframe
<kbd>k</kbd> Save Trim End Position

Seeking

Seek to saved positions

<kbd>shift</kbd> + <kbd>h</kbd> Seek to the saved Trim start position
<kbd>shift</kbd> + <kbd>k</kbd> Seek to the saved Trim end position

With video file

<kbd>LEFT</kbd> Seek backward by keyframe (Minimum distance)
<kbd>RIGHT</kbd> Seek forward by keyframe (Minimum distance)
<kbd>UP</kbd> Seek forward by keyframe (Larger distance)
<kbd>DOWN</kbd> Seek backward by keyframe (Larger distance)
<kbd>shift+LEFT</kbd> Seek backward exactly by seconds (-0.1 seconds)
<kbd>shift+RIGHT</kbd> Seek forward exactly by seconds (0.1 seconds)
<kbd>shift+UP</kbd> Seek forward exactly by seconds (0.5 seconds)
<kbd>shift+DOWN</kbd> Seek backward exactly by seconds (-0.5 seconds)

With audio file

<kbd>LEFT</kbd> Seek backward by seconds (-1 seconds)
<kbd>RIGHT</kbd> Seek forward by seconds (1 seconds)
<kbd>UP</kbd> Seek forward by seconds (5 seconds)
<kbd>DOWN</kbd> Seek backward by seconds (-5 seconds)
<kbd>shift+LEFT</kbd> Seek backward by seconds (-10 seconds)
<kbd>shift+RIGHT</kbd> Seek forward by seconds (10 seconds)
<kbd>shift+UP</kbd> Seek forward by seconds (30 seconds)
<kbd>shift+DOWN</kbd> Seek backward by seconds (-30 seconds)

To create a valid video file

Beggining of the trim position must be a keyframe.
End position can be any point.

Concat with `ffmpeg`

After splitting, you can concat them with a script something like this.

CLIPS=("example_1.mp4" "example_2.mp4")
DESTINATION="concat_example.mp4"

ffmpeg \
    -hide_banner \
    -loglevel verbose \
    -f concat \
    -safe 0 \
    -auto_convert 0 \
    -err_detect ignore_err \
    -i <(
        while read -r; do
            echo "file '$REPLY'"
        done <<< "${CLIPS[*]}"
    ) \
    -copy_unknown \
    -map_chapters 0 \
    -c copy \
    "$DESTINATION"

Known Issue

Any embedded media other than video / audio will be lost, such as embedded subtitles. This will unlikely be fixed.