MKVINFO(1) | User Commands | MKVINFO(1) |
NAME¶
mkvinfo - Print information about elements in Matroska files
SYNOPSIS¶
mkvinfo [options] {source-filename}
DESCRIPTION¶
This program lists all elements contained in a Matroska. The output can be limited to a list of tracks in the file including information about the codecs used.
-g, --gui
-c, --checksums
-s, --summary
-t, --track-info
-x, --hexdump
-X, --full-hexdump
-z, --size
--command-line-charset character-set
--output-charset character-set
-r, --redirect-output file-name
--ui-language code
--debug topic
--engage feature
--gui-mode
This switch has nothing to do with the --gui parameter which causes mkvinfo to display its own GUI.
-v, --verbose
-h, --help
-V, --version
--check-for-updates
Afterwards the program exists with an exit code of 0 if no newer release is available, with 1 if a newer release is available and with 2 if an error occured (e.g. if the update information could not be retrieved).
This option is only available if the program was built with support for libcurl.
@options-file.json
VERBOSITY LEVELS¶
The -v option can be used to increase mkvinfo(1)'s verbosity level and print more information about the current file.
At level 0 mkvinfo(1) will print only the track headers it finds and their types. mkvinfo(1) will exit as soon as the headers are parsed completely (more technical: as soon as the first cluster is encountered). In this level the seek head entries and the cues will not be displayed -- even if they're located in front of the track information.
At level 1 mkvinfo(1) will also print all Matroska elements encountered for the complete file but the seek head entries and the cue entries. If the summary mode is enabled then mkvinfo(1) will output the frame position as well.
At level 2 mkvinfo(1) will also print the seek head entries, the cue entries and the file position at which each Matroska element can be found at.
At level 3 and above mkvinfo(1) will print some information that is not directly connected to a Matroska element. All other elements only print stuff about the elements that were just found. Level 3 adds meta information to ease debugging (read: it's intended for developers only). All lines written by level 3 are enclosed in square brackets to make filtering them out easy.
TEXT FILES AND CHARACTER SET CONVERSIONS¶
For an in-depth discussion about how all tools in the MKVToolNix suite handle character set conversions, input/output encoding, command line encoding and console encoding please see the identically-named section in the mkvmerge(1) man page.
EXIT CODES¶
mkvinfo(1) exits with one of three exit codes:
ESCAPING SPECIAL CHARS IN TEXT¶
There are a few places in which special characters in text must or should be escaped. The rules for escaping are simple: each character that needs escaping is replaced with a backslash followed by another character.
The rules are: ' ' (a space) becomes '\s', '"' (double quotes) becomes '\2', ':' becomes '\c', '#' becomes '\h' and '\' (a single backslash) itself becomes '\\'.
ENVIRONMENT VARIABLES¶
mkvinfo(1) uses the default variables that determine the system's locale (e.g. LANG and the LC_* family). Additional variables:
MKVINFO_DEBUG, MKVTOOLNIX_DEBUG and its short form MTX_DEBUG
MKVINFO_ENGAGE, MKVTOOLNIX_ENGAGE and its short form MTX_ENGAGE
MKVINFO_OPTIONS, MKVTOOLNIX_OPTIONS and its short form MTX_OPTIONS
SEE ALSO¶
mkvmerge(1), mkvextract(1), mkvpropedit(1), mkvtoolnix-gui(1)
WWW¶
The latest version can always be found at the MKVToolNix homepage[1].
AUTHOR¶
Moritz Bunkus <moritz@bunkus.org>
NOTES¶
- 1.
- the MKVToolNix homepage
2017-05-20 | MKVToolNix 12.0.0 |