Vidmerger

A wrapper around FFmpeg which simplifies merging of multiple videos.

%%{init: {'themeVariables': { 'mainBkg': 'white', 'nodeBorder': 'black' }}}%%
graph LR;
Video_A-->Vidmerger;
Video_B-->Vidmerger;
Vidmerger-->FPS_Changer;
FPS_Changer-->Merger;
Merger-->Chapterer;
Chapterer-->Video_A+B;

Vidmerger-->Merger;
Merger-->Video_A+B;

🙉 What is this exactly?

Vidmerger is a command-line-tool which uses ffmpeg to merge multiple video-files with the same file-extension into one file, for example running vidmerger . on mp4 files would create a merged video called output.mp4 🐣

Here is the usage help of vidmerger 🤗

A wrapper around ffmpeg which simlifies merging multiple videos 🎞  Everything in between the first
`-` till the fill extension of the input files will be used as chapter titles.

USAGE:
    vidmerger [OPTIONS] <TARGET_DIR>

ARGS:
    <TARGET_DIR>    Sets the input file to use

OPTIONS:
    -f, --format <format>     Specifies which formats should be merged individually, the default is
                              👉 3g2,3gp,aac,ac3,alac,amr,ape,au,avi,awb,dts,f4a,f4b,f4p,f4v,flac,flv,m4a,m4b,m4p,m4r,m4v,mkv,mov,mp2,mp3,mp4,mpeg,mpg,oga,ogg,ogm,ogv,ogx,opus,pcm,spx,wav,webm,wma,wmv
        --fps <fps>           Generates videos inside a temporary folder with this fps value and
                              merges them
    -h, --help                Print help information
        --shutdown            For doing a shutdown at the end (needs sudo)
        --skip-chapterer      Skips the chapterer
        --skip-fps-changer    Skips the fps changer
        --skip-wait           Skips the wait time for reading
    -V, --version             Print version information```

✨ Installing / Getting started

You can install it on all the three major operating systems 🤗

X64

ARM64

🐳 Run it without installing

You can also use Docker to run vidmerger without installing anything except Docker, hosted on Dockerhub.

docker container run -v <PATH-TO-YOUR-VIDEOS>:/data tgotwig/vidmerger

Examples with Bash:

docker container run -v ./data:/data tgotwig/vidmerger
docker container run -v ./data:/data tgotwig/vidmerger --version

⚙️ Developing

Built With

Rust and some listed Crates inside of Cargo.toml under dependencies.

Prerequisites

• Rust 2021
• yt-dlp
• ffmpeg
• task

Setting up Dev

Once you are done with installing the prerequisites, you should run task to see if everything runs smooth:

git clone [email protected]:TGotwig/vidmerger.git
cd vidmerger
task

Also click on fork from the top right corner of this repository and run:

git remote add <your-github-name> [email protected]:<your-github-name>/vidmerger.git

Here is a little tutorial about working with forks along with GitKraken 🐙

Building

Run task build to build for Mac, Linux and Windows. You can find the compressed Mac & Linux .tar.gz-archives for Github under target/tars, the .exe file for Windows under tools.

Deploying / Publishing

Automated steps

• Homebrew (MacOS & Linux): Gets automatically deployed by release.yml after pushing a git tag.
• Chocolatey (Windows): Gets automatically deployed by release.yml after pushing a git tag.

Manual steps

Increasing all versions by find and replace, then after task build:

• Dockerhub: Run task publish_dockerhub.

📦 Versioning

We use SemVer for versioning.

🧪 Tests

• For major tests: task test (requires yt-dlp and ffmpeg to be installed)
• For linting tests: task lint

🌟 Style guide

• rust-clippy
• rls-vscode
• conventionalcommits

📜 Licensing

MIT License with “Commons Clause”.