1MKVINFO(1) User Commands MKVINFO(1)
2
6 mkvinfo - Print information about elements in Matroska(TM) files
7
9 mkvinfo [options] {source-filename}
10
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 -c, --checksums
17 Calculates and display the Adler-32 checksum for each frame. Useful
18 for debugging only.
19 -s, --summary
21 Only show a terse summary of what mkvinfo(1) finds and not each
22 element.
23 -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 -x, --hexdump
29 Show the first 16 bytes of each frame as a hex dump.
30 -X, --full-hexdump
32 Show all bytes of each frame as a hex dump.
33 -z, --size
35 Show the size of each element including its header.
36 --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 --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 -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 --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 --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 --debug topic
64 Turn on debugging for a specific feature. This option is only
65 useful for developers.
66 --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 --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 -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 -h, --help
85 Show usage information and exit.
86 -V, --version
88 Show version information and exit.
89 @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
96 The -v option can be used to increase mkvinfo(1)'s verbosity level and
97 print more information about the current file.
98 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 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 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 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
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
129 mkvinfo(1) exits with one of three exit codes:
130 · 0 -- This exit codes means that the run has completed successfully.
132 · 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 · 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
143 mkvinfo(1) uses the default variables that determine the system's
144 locale (e.g. LANG and the LC_* family). Additional variables:
145 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 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
155 mkvmerge(1), mkvextract(1), mkvpropedit(1), mkvtoolnix-gui(1)
156
158 The latest version can always be found at the MKVToolNix homepage[1].
159
161 Moritz Bunkus <moritz@bunkus.org>
162 Developer
163
165 1. the MKVToolNix homepage
166 https://mkvtoolnix.download/
167MKVToolNix 34.0.0 2019-05-18 MKVINFO(1)