diff --git a/mkvextract.1 b/mkvextract.1 new file mode 100644 index 000000000..6f5321a12 --- /dev/null +++ b/mkvextract.1 @@ -0,0 +1,75 @@ +.TH MKVEXTRACT "1" "June 2003" "mkvextract v0.5.0" "User Commands" +.SH NAME +mkvextract \- extract tracks from Matroska files into other files +.SH SYNOPSIS +.B mkvextract +[\fIoptions\fR] \fB-i\fR \fIinname\fR [\fITID1\fR:\fIoutname1\fR [\fITID2\fR:\fIoutname2\fR ...]] +.SH DESCRIPTION +.LP +This program extracts selected tracks from a single Matroska file to other +suitable file formats. +.TP +\fB\-i\fR \fIinname\fR +Use '\fIinname\fR' as the source. +.TP +\fB\-c\fR \fIcharset\fR +Sets the charset to convert the next text subtitle track to. Only valid if the +next track ID targets a text subtitle track. +.TP +\fITID\fR:\fIoutname\fR +Causes extraction of the track with the ID \fITID\fR into the file +\fIoutname\fR if such a track exists in the source file. This option can be +given mutliple times. The track IDs are the same as the ones output by +\fBmkvmerge\fR's \fB--identify\fR option. +.TP +\fB\-v\fR, \fB\-\-verbose\fR +Be verbose and show all the important Matroska elements as they're read. +.TP +\fB\-h\fR, \fB\-\-help\fR +Show usage information. +.TP +\fB\-V\fR, \fB\-\-version\fR +Show version information. + +.SH NOTES +The decision about the output format is based on the track type, not on the +extension used for the output file name. The following track types are +supported at the moment: +.TP +V_MS/VFW/FOURCC +Fixed FPS video tracks with this CodecID are written to AVI files. +.TP +A_MPEG/L3, A_AC3 +These will be extracted to raw MP3 and AC3 files. +.TP +A_PCM/INT/LIT +Raw PCM data will be written to a WAV file. +.TP +A_AAC/MPEG2/* +All MPEG2 AAC files will be written into an AAC file with ADTS headers before +each packet. +.TP +A_AAC/MPEG4/* +All MPEG4 AAC files will be written into an AAC file with ADTS headers before +each packet. The ADTS headers will not contain the deprecated emphasis field. +.TP +A_VORBIS +Vorbis audio will be written into an Ogg/Vorbis file. +.TP +S_TEXT/UTF8 +Simple text subtitles will be written as SRT files. +.TP +S_TEXT/SSA, S_TEXT/ASS +SSA and ASS text subtitles will be written as SSA/ASS files respectively. + +.SH AUTHOR +.I mkvextract +was written by Moritz Bunkus . +.SH SEE ALSO +.BR mkvmerge (1) +.BR mkvinfo (1) +.SH WWW +The newest version can always be found at +.UR http://www.bunkus.org/videotools/mkvtoolnix/ + +.UE