Tools for Batch Video File Manipulations

Overview

TwoTone is a versatile tool with various subtools for batch video file manipulations.

Running TwoTone

To run TwoTone, use the following command:

python -m twotone <global options> <tool-name> <tool-specific options>

Getting Help

To see a list of global options, available tools, and their descriptions:

python -m twotone --help

To get help for a specific tool:

python -m twotone <tool-name> --help

Important Notes

Dry Run Mode: all tools run in a dry run mode by default (no files are being modified). Use the -r or --no-dry-run global option to perform actual operation. In live run mode most tools remove their input files after successful processing.
It is safe to stop execution with ctrl+c. All tools handle proper signal and will stop as soon as possible.
Working Directory: use -w or --working-dir to specify where temporary and working files are created. By default the directory is taken from the operating system's user data location for the application.

Data Safety: Always back up your data before using any tool, as source files may be deleted during processing.

Available Tools

Merge Video Files with Subtitles into MKV Files

The merge tool searches for movie and subtitle files and merges them into a single MKV file.

By default, subtitles are added without a language label. You can specify a language with the --language option.

For a full list of options:

python -m twotone merge --help

Automatic Video transcoding

The transcode tool transcodes videos using the x265 codec.

It takes a video directory as an input and determines the optimal CRF for each video by comparing the original and encoded versions. The script aims to achieve a quality level where SSIM ≈ 0.98 (by default).

For a full list of options:

python -m twotone transcode --help

Movies concatenation

The concatenate tool looks for movie files which seem to be split into a few files (like CD1, CD2 etc) and glues them into one file.

python -m twotone concatenate --help

Combine Duplicate Videos (melt)

The melt tool scans for duplicate video files and creates a single output using the best quality segments from each copy. Duplicates can be provided manually or taken from a Jellyfin server. Input files are kept intact by default.

python -m twotone melt --help

Miscellaneous utilities

The utilities tool groups smaller helpers. Currently it provides the scenes subtool for extracting frames from a video and saving them into per-scene folders.

python -m twotone utilities scenes --help