Crates.io | trimmeroni |
lib.rs | trimmeroni |
version | 0.2.2 |
source | src |
created_at | 2023-05-09 23:23:05.303531 |
updated_at | 2024-07-14 00:56:22.953299 |
description | Cut and concatenate video clips without reencoding |
homepage | |
repository | |
max_upload_size | |
id | 860885 |
size | 25,177 |
This little tool aims to make it easier to cut and concatenate together any number of video clips, from any number of input files, into one output file, without reencoding. Compared to editing the clips using video editing or transcoding software, this preserves original video quality, and saves processing time.
It uses the ffmpeg
program under the hood to copy each requested video segment from the source
files into a temporary directory, and then concatenate them (insert one after another) into
the destination file.
The only requirement is that you have ffmpeg
installed on your system, accessible from PATH
.
From "cool_gameplay.mkv", grab the segment between 08:34 and 11:02, and save it to "360_noscope.mp4"
trimmeroni -i 'cool_gameplay.mkv @ 08:34 - 11:02' "360_noscope.mp4"
From "camera_footage.mp4", use the segments 04:20 - 04:59, 06:44 - 09:00, and from 14:40 to the end, concatenate them, and save the result to "check_this_out.mp4"
trimmeroni -i 'camera_footage.mp4 @ 04:20 - 04:59, 06:44 - 09:00, 14:40 - ' "check_this_out.mp4"
Take 38:08 to 45:35, and 1:02:20 to 1:17:52 from "Day1.mp4", and from the beginning to 29:26 from "Day2.mp4", concatenate, and save the result to "Weekend bike adventure.mp4"
trimmeroni -i 'Day1.mp4 @ 38:08 - 45:35, 1:02:20 - 1:17:52' -i 'Day2.mp4 @ - 29:26' "Weekend bike adventure.mp4"
Usage: trimmeroni [OPTIONS] <OUTPUT_NAME>
Arguments:
<OUTPUT_NAME>
Options:
-i, --input-clip <INPUT_CLIP_SPECS>
-v, --verbose Print additional information while working
-h, --help Print help information
-V, --version Print version information
<INPUT_CLIP_SPECS>
specifies an input file and the timecodes of clips to copy from it. It should
be formatted as follows:
INPUT_NAME @ TIMECODE - TIMECODE[, TIMECODE - TIMECODE, ...]
where
INPUT_NAME
is the input file name; if the file name contains "@", use another "@" to escape it
("@@"); there is no need to escape spaces;TIMECODE
can be any seek position supported by ffmpeg
(e.g. in h:mm:ss
format),
or empty, meaning either the start or end of the entire video file;TIMECODE - TIMECODE,
" can be repeated any number of times in order to grab more than one clip
from the input file.You can use -i
many times to use clips from many source files.
Remember to quote your <INPUT_CLIP_SPECS>
, so that trimmeroni
receives it as a single string.
The start of each clip will be snapped to the nearest keyframe before the specified timecode. For recordings from OBS Studio, for example, this may mean that the clip will include a segment from up to 2 seconds earlier.
Use -v
or --verbose
to get additional info from trimmeroni
and ffmpeg
.
If you have cargo
, you can install this program from crates.io:
cargo install trimmeroni
This project uses Rust's stable toolchain, 2021 edition.
To build locally from source:
git clone https://github.com/outfrost/trimmeroni.git
cd trimmeroni
cargo build
You can then run the debug binary like so:
cargo run -- -i 'file.mkv @ 00:02 - 01:12' "out.mp4"
or install it to your cargo
binaries with:
cargo install --path .
Issues and pull requests welcome.
By opening an issue or pull request for this repository, you acknowledge and agree that the contributions included in your issue or pull request may be published, used, copied, modified, repurposed, and reused without limitation, under the terms of the MIT License (included in LICENSE), regardless of whether or not the pull request is ever merged, and whether or not the issue is ever resolved.
If you would like your name to be included in the list of contributors in the copyright message, please edit the LICENSE file as part of your pull request.