mkvtool
mkvtool [<flags>] <command> [<args> ...]
A swiss army knife for easy operations on Matroska containers.
This program provides a simpler front-end to common operations involving Matroska containers. It hides details and complexities from utilities in the mkvtoolnix suite, such as mkvmerge, mkvpropedit, and others.
--help: Show context-sensitive help (also try --help-long and --help-man).
-n, --dry-run: Dry-run mode (only show commands or output.)
Show help.
Merge multiple input files (containing their respective media tracks) into
<output-file>.
This operation takes multiple input files (of any format recognized by mkvmerge) and creates a new MKV file containing all tracks read from the input files. A common use of this feature is to add a subtitle track to an existing file that contains only A/V tracks (E.g., to create a MKV file with the A/V tracks from an MP4 file and subtitles from a SRT file.)
The boolean flag --subs causes the program to copy all subtitles in
<input-file> (default=true). Use --nosubs to replace all input subtitle
tracks in a MKV file with one or more subtitle tracks coming from external
files (E.g, SRT files).
Note: The program does not check the contents of the input files. It is entirely possible to create files with multiple video, audio, and subtitle tracks (although we typically want only one video track in the output file.)
-o, --output=OUTPUT: Output file.
--subs: Copy subs from video file (use --nosubs to ignore all subs in the source file.)
Copy the <input-file> MKV to <output-file> with all subtitle tasks removed,
except <track>. This operation is useful when a file contains many subtitle
tracks and, for some reason, you need a copy of the file with only one subtitle
track.
Remux the original file <input-file> into <output-file>. This option can be
useful to recover damaged MKV files or remux files using a newer version of
mkvtoolnix.
Rename <input-files> into a standardized format, using metadata in the
original filenames.
Attempt to fetch metadata (title, season, year, resolution, etc) from each of
the filenames specified in <input-files>. The filenames themselves are parsed
for data, so this is a "best effort" operation. Each filename is renamed
following a simplified format, compatible with most streaming applications.
Note: For TV series, There's no clean way to fetch the episode name, so this information will be lost during the rename. Most streaming servers fill that information in their databases based on Title, Episode, and Season, so that tends not to be a problem for most people.
Set the track specified with the <track> argument as the default track
in <mkvfile>.
Default tracks tell the player which track (in the presence of multiple tracks of the same type) should be played. It's most commonly used for audio and subtitle tracks. Not all players obey these settings (bust empirically, most appear to do the right thing.)
Set the track with the first matching language as the default track.
This option sets the default track based on the track language. Use the
--lang option to select a set of languages to match. It's possible to specify
--lang multiple times, in which case the first match will prevail.
There's also the "default" meta-language, which matches the default
language in the MKV file (normally, shown as an empty language when
using the show option).
For example, using `--lang=en --lang=es --lang=defaultj will cause the program to first attempt to find a subtitle track in the English language. If no subtitle tracks in English exist, it will attempt Spanish next. As a last resort, a subtitle track with the "default" language will be matched and set as the default subtitle track (if it exists.)
It's also possible to ignore strings in the title with the --ignore flag.
This is useful to ignore "Forced" subtitles, for example.
This command only works in subtitle tracks for now.
Useful command example:
$ subtool setdefaultbylang --lang=eng --lang=default --lang=und --ignore="force" *.mkvThis will set the first subtitle track in English (change to your favorite language) to be the default subtitle track. Failing that, it will attempt the default language and "und" (some files have one subtitle track marked as "undefined".)
--lang=LANG: Preferred languages (Use multiple times. Use 'default' for tracks with no language set.)
--ignore=IGNORE: Ignore tracks with this string in the name (can be used multiple times.)
Shows a listing of all tracks in the file.
-u, --uid: Include track UIDs in the output.
Show version information.
- (C) 2021 by Marco Paganini