mkvtoolnix/doc/mkvinfo.1
Moritz Bunkus 72320f6142 Preparations for release 2.9.7.
Bumped the version number. Set the release code name. Added the
release message.
2009-07-01 18:40:03 +02:00

92 lines
3.2 KiB
Groff

.TH MKVINFO "1" "July 2009" "mkvinfo v2.9.7" "User Commands"
.SH NAME
mkvinfo \- Print information about tracks in Matroska files
.SH SYNOPSIS
.B mkvinfo
[\fIoptions\fR] \fIinname\fR
.SH DESCRIPTION
.LP
This program lists all tracks contained in a Matroska file including
information about the codecs used.
.TP
inname
Use '\fIinname\fR' as the source.
.TP
\fB\-g\fR, \fB\-\-gui\fR
Start the GUI. This option is only available if mkvinfo was compiled with
GUI support.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Be verbose and show all Matroska elements. See the section
\'\fBVERBOSITY LEVELS\fR' for details.
.TP
\fB\-c\fR, \fB\-\-checksums\fR
Calculates and display the Adler32 checksum for each frame. Useful for
debugging only.
.TP
\fB\-s\fR, \fB\-\-summary\fR
Only show a terse summary of what \fBmkvinfo\fR finds and not each element.
.TP
\fB\-\-output\-charset\fR <\fIcharset\fR>
Sets the charset to which strings are converted that are to be output.
It defaults to the charset given by system's current locale.
.TP
\fB-r\fR, \fB\-\-redirect\-output\fR <\fIfilename\fR>
Writes all messages to the file \fIfilename\fR instead of to the console.
While this can be done easily with output redirection there are cases in which
this option is needed: when the terminal reinterprets the output before
writing it to a file.
The charset set with \fB\-\-output-charset\fR is honored.
.TP
\fB\-\-ui\-language\fR <\fIcode\fR>
Forces the translations for the language \fIcode\fR to be used (e.g.
\fIde_DE\fR for the German translations). If is preferable to use the
environment variables LANG, LC_MESSAGES and LC_ALL though. Entering "list" as
the \fIcode\fR will cause mkvinfo to output a list of available translations.
.TP
\fB\-h\fR, \fB\-\-help\fR
Show usage information.
.TP
\fB\-V\fR, \fB\-\-version\fR
Show version information.
.SH VERBOSITY LEVELS
.LP
The \fB-v\fR option can be used to increase \fBmkvinfo\fR's verbosity level
and print more information about the current file.
.TP
level 0
will print only the track headers it finds and their types. \fBmkvinfo\fR
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.
.TP
level 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 \fBmkvinfo\fR will output the frame position as well.
.TP
level 2
will also print the seek head entries, the cue entries and the file position
at which each Matroska element can be found at.
.TP
level 3
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.
.LP
.SH AUTHOR
.I mkvinfo
was written by Moritz Bunkus <moritz@bunkus.org>.
.SH SEE ALSO
.BR mkvmerge (1),
.BR mkvextract (1),
.BR mmg (1)
.SH WWW
The newest version can always be found at
.UR http://www.bunkus.org/\:videotools/\:mkvtoolnix/
www.bunkus.org
.UE