1MKVINFO(1)                       User Commands                      MKVINFO(1)
2
3
4

NAME

6       mkvinfo - Print information about elements in Matroska(TM) files
7

SYNOPSIS

9       mkvinfo [options] {source-filename}
10

DESCRIPTION

12       This program lists all elements contained in a Matroska(TM). The output
13       can be limited to a list of tracks in the file including information
14       about the codecs used.
15
16       -c, --checksums
17           Calculates and display the Adler-32 checksum for each frame. Useful
18           for debugging only.
19
20       -s, --summary
21           Only show a terse summary of what mkvinfo(1) finds and not each
22           element.
23
24       -t, --track-info
25           Show statistics for each track in verbose mode. Also sets verbosity
26           to 1 if it was at level 0 before.
27
28       -x, --hexdump
29           Show the first 16 bytes of each frame as a hex dump.
30
31       -X, --full-hexdump
32           Show all bytes of each frame as a hex dump.
33
34       -z, --size
35           Show the size of each element including its header.
36
37       --command-line-charset character-set
38           Sets the character set to convert strings given on the command line
39           from. It defaults to the character set given by system's current
40           locale.
41
42       --output-charset character-set
43           Sets the character set to which strings are converted that are to
44           be output. It defaults to the character set given by system's
45           current locale.
46
47       -r, --redirect-output file-name
48           Writes all messages to the file file-name instead of to the
49           console. While this can be done easily with output redirection
50           there are cases in which this option is needed: when the terminal
51           reinterprets the output before writing it to a file. The character
52           set set with --output-charset is honored.
53
54       --ui-language code
55           Forces the translations for the language code to be used (e.g.
56           'de_DE' for the German translations). Entering 'list' as the code
57           will cause the program to output a list of available translations.
58
59       --abort-on-warnings
60           Tells the program to abort after the first warning is emitted. The
61           program's exit code will be 1.
62
63       --debug topic
64           Turn on debugging for a specific feature. This option is only
65           useful for developers.
66
67       --engage feature
68           Turn on experimental features. A list of available features can be
69           requested with mkvinfo --engage list. These features are not meant
70           to be used in normal situations.
71
72       --gui-mode
73           Turns on GUI mode. In this mode specially-formatted lines may be
74           output that can tell a controlling GUI what's happening. These
75           messages follow the format '#GUI#message'. The message may be
76           followed by key/value pairs as in
77           '#GUI#message#key1=value1#key2=value2...'. Neither the messages nor
78           the keys are ever translated and always output in English.
79
80       -v, --verbose
81           Be more verbose. See the section about verbosity levels for a
82           description which information will be output at which level.
83
84       -h, --help
85           Show usage information and exit.
86
87       -V, --version
88           Show version information and exit.
89
90       @options-file.json
91           Reads additional command line arguments from the file options-file.
92           For a full explanation on the supported formats for such files see
93           the section called "Option files" in the mkvmerge(1) man page.
94

VERBOSITY LEVELS

96       The -v option can be used to increase mkvinfo(1)'s verbosity level and
97       print more information about the current file.
98
99       At level 0 mkvinfo(1) will print only the track headers it finds and
100       their types.  mkvinfo(1) will exit as soon as the headers are parsed
101       completely (more technical: as soon as the first cluster is
102       encountered). In this level the seek head entries and the cues will not
103       be displayed -- even if they're located in front of the track
104       information.
105
106       At level 1 mkvinfo(1) will also print all Matroska(TM) elements
107       encountered for the complete file but the seek head entries and the cue
108       entries. If the summary mode is enabled then mkvinfo(1) will output the
109       frame position as well.
110
111       At level 2 mkvinfo(1) will also print the seek head entries, the cue
112       entries and the file position at which each Matroska(TM) element can be
113       found at.
114
115       At level 3 and above mkvinfo(1) will print some information that is not
116       directly connected to a Matroska(TM) element. All other elements only
117       print stuff about the elements that were just found. Level 3 adds meta
118       information to ease debugging (read: it's intended for developers
119       only). All lines written by level 3 are enclosed in square brackets to
120       make filtering them out easy.
121

TEXT FILES AND CHARACTER SET CONVERSIONS

123       For an in-depth discussion about how all tools in the MKVToolNix suite
124       handle character set conversions, input/output encoding, command line
125       encoding and console encoding please see the identically-named section
126       in the mkvmerge(1) man page.
127

EXIT CODES

129       mkvinfo(1) exits with one of three exit codes:
130
131       ·   0 -- This exit codes means that the run has completed successfully.
132
133       ·   1 -- In this case mkvinfo(1) has output at least one warning, but
134           the run did continue. A warning is prefixed with the text
135           'Warning:'.
136
137       ·   2 -- This exit code is used after an error occurred.  mkvinfo(1)
138           aborts right after outputting the error message. Error messages
139           range from wrong command line arguments over read/write errors to
140           broken files.
141

ENVIRONMENT VARIABLES

143       mkvinfo(1) uses the default variables that determine the system's
144       locale (e.g.  LANG and the LC_* family). Additional variables:
145
146       MKVINFO_DEBUG, MKVTOOLNIX_DEBUG and its short form MTX_DEBUG
147           The content is treated as if it had been passed via the --debug
148           option.
149
150       MKVINFO_ENGAGE, MKVTOOLNIX_ENGAGE and its short form MTX_ENGAGE
151           The content is treated as if it had been passed via the --engage
152           option.
153

SEE ALSO

155       mkvmerge(1), mkvextract(1), mkvpropedit(1), mkvtoolnix-gui(1)
156

WWW

158       The latest version can always be found at the MKVToolNix homepage[1].
159

AUTHOR

161       Moritz Bunkus <moritz@bunkus.org>
162           Developer
163

NOTES

165        1. the MKVToolNix homepage
166           https://mkvtoolnix.download/
167
168
169
170MKVToolNix 40.0.0                 2019-11-09                        MKVINFO(1)
Impressum