mirror of
https://gitlab.com/mbunkus/mkvtoolnix.git
synced 2024-12-25 04:11:44 +00:00
171 lines
6.1 KiB
Plaintext
171 lines
6.1 KiB
Plaintext
MKVToolNix 1.5.6
|
|
================
|
|
|
|
With these tools one can get information about (mkvinfo) Matroska
|
|
files, extract tracks/data from (mkvextract) Matroska files and create
|
|
(mkvmerge) Matroska files from other media files. Matroska is a new
|
|
multimedia file format aiming to become THE new container format for
|
|
the future. You can find more information about it and its underlying
|
|
technology, the Extensible Binary Meta Language (EBML), at
|
|
|
|
http://www.matroska.org/
|
|
|
|
The full documentation for each command is now maintained in its
|
|
man page only. Type 'mkvmerge -h' to get you started.
|
|
|
|
This code comes under the GPL (see www.gnu.org or the file COPYING).
|
|
Modify as needed.
|
|
|
|
The newest version can always be found at
|
|
http://www.bunkus.org/videotools/mkvtoolnix/
|
|
|
|
Moritz Bunkus <moritz@bunkus.org>
|
|
|
|
Installation
|
|
------------
|
|
|
|
If you want to compile the tools yourself then you must first decide
|
|
if you want to use a 'proper' release version or the current
|
|
development version. As both Matroska and MKVToolNix are under heavy
|
|
development there might be features available in the Subversion
|
|
repository that are not available in the releases. On the other hand
|
|
the Subversion repository version might not even compile.
|
|
|
|
* Requirements
|
|
|
|
In order to compile MKVToolNix you need a couple of libraries. Most of
|
|
them should be available pre-compiled for your distribution. The
|
|
libraries you absolutely need are:
|
|
|
|
- libebml and libmatroska for low-level access to Matroska files.
|
|
Instructions on how to compile them are a bit further down in this
|
|
file.
|
|
- expat ( http://expat.sourceforge.net/ ) -- a light-weight XML
|
|
parser library
|
|
- libOgg ( http://downloads.xiph.org/releases/ogg/ ) and libVorbis
|
|
( http://downloads.xiph.org/releases/vorbis/ ) for access to Ogg/OGM
|
|
files and Vorbis support
|
|
- zlib ( http://www.zlib.net/ ) -- a compression library
|
|
|
|
Other libraries are optional and only limit the features that are
|
|
built. These include:
|
|
|
|
- wxWidgets ( http://www.wxwidgets.org/ ) -- a cross-platform GUI
|
|
toolkit. You need this if you want to use mmg (the mkvmerge GUI) or
|
|
mkvinfo's GUI.
|
|
- libFLAC ( http://downloads.xiph.org/releases/flac/ ) for FLAC
|
|
support (Free Lossless Audio Codec)
|
|
- lzo ( http://www.oberhumer.com/opensource/lzo/ ) and bzip2 (
|
|
http://www.bzip.org/ ) are compression libraries. These are the
|
|
least important libraries as almost no application supports Matroska
|
|
content that is compressed with either of these libs. The
|
|
aforementioned zlib is what every program supports.
|
|
|
|
* Building libmatroska and libebml
|
|
|
|
Start with the two libraries. Either get libebml 0.7.5 from
|
|
http://dl.matroska.org/downloads/libebml/ and libmatroska 0.7.7 from
|
|
http://dl.matroska.org/downloads/libmatroska/ or a fresh copy from the
|
|
Subversion repository:
|
|
|
|
svn co https://svn.matroska.org/svn/matroska/trunk/libebml
|
|
svn co https://svn.matroska.org/svn/matroska/trunk/libmatroska
|
|
|
|
Change to "libebml/make/linux" and run "make staticlib". If you have
|
|
root-access then run "make install_staticlib" as "root" in order to
|
|
install the files. Change to "libmatroska/make/linux". Once more run
|
|
"make staticlib". If you have root-access then run "make
|
|
install_staticlib" as "root" in order to install the files.
|
|
|
|
* Building MKVtoolNix
|
|
|
|
Either download the release 1.5.5 from
|
|
http://www.bunkus.org/videotools/mkvtoolnix/sources/mkvtoolnix-1.5.5.tar.bz2
|
|
and unpack it or get a fresh copy from my Subversion repository. All
|
|
you need for Subversion repository access is to download a Subversion
|
|
client from the Subversion homepage at http://subversion.tigris.org/ .
|
|
There are clients for both Unix/Linux and Windows. It basically works
|
|
like CVS. So the typical way to check out a fresh copy looks like
|
|
this:
|
|
|
|
svn co https://svn.bunkus.org/mosu/trunk/prog/video/mkvtoolnix
|
|
|
|
Additional step if you're using the development version from the
|
|
Subversion respository:
|
|
|
|
Change to the MKVtoolNix directory and run "./autogen.sh" which
|
|
will generate the "configure" script.
|
|
|
|
If you have run "make install" for both libraries then "configure"
|
|
should automatically find the libraries' position. Otherwise you need
|
|
to tell "configure" where the "libebml" and "libmatroska" include and
|
|
library files are:
|
|
|
|
./configure \
|
|
--with-extra-includes=/where/i/put/libebml\;/where/i/put/libmatroska \
|
|
--with-extra-libs=/where/i/put/libebml/make/linux\;/where/i/put/libmatroska/make/linue
|
|
|
|
Now run "make" and, as "root", "make install".
|
|
|
|
Example
|
|
-------
|
|
|
|
Here's a *very* brief example of how you could use mkvmerge
|
|
with mencoder in order to rip a DVD:
|
|
|
|
a) Extract the audio to PCM audio:
|
|
|
|
mplayer -ao pcm -aofile audio.wav -vo null -vc dummy dvd://1
|
|
|
|
b) Normalize the sound (optional)
|
|
|
|
normalize audio.wav
|
|
|
|
c) Encode the audio to Vorbis:
|
|
|
|
oggenc -q3 -oaudio-q3.ogg audio.wav
|
|
|
|
d) Somehow calculate the bitrate for your video. Use something like...
|
|
|
|
video_size = (target_size - audio-size) / 1.005
|
|
video_bitrate = video_size / length / 1024 * 8
|
|
|
|
target_size, audio_size in bytes
|
|
length in seconds
|
|
1.005 is the overhead caused by putting the streams into an Matroska file
|
|
(about 0.5%, that's correct ;)).
|
|
video_bitrate will be in kbit/s
|
|
|
|
e) Use the two-pass encoding for the video:
|
|
|
|
mencoder -dvd 1 -oac copy -ovc lavc \
|
|
-lavcopts vcodec=mpeg4:vbitrate=1000:vhq:vqmin=2:vpass=1 \
|
|
-vop scale=....,crop=..... \
|
|
-o /dev/null
|
|
|
|
mencoder -dvd 1 -oac copy -ovc lavc \
|
|
-lavcopts vcodec=mpeg4:vbitrate=1000:vhq:vqmin=2:vpass=2 \
|
|
-vop scale=....,crop=..... \
|
|
-o movie.avi
|
|
|
|
f) Merge:
|
|
|
|
mkvmerge -o movie.mkv -A movie.avi audio-q3.ogg
|
|
|
|
-A is necessary in order to avoid copying the raw PCM (or MP3) audio as well.
|
|
|
|
Bug reports
|
|
-----------
|
|
|
|
If you're sure you've found a bug - e.g. if one of my programs crashes
|
|
with an obscur error message, or if the resulting file is missing part
|
|
of the original data, then by all means submit a bug report.
|
|
|
|
I use Anthill (http://www.bunkus.org/anthill/index.php) as my bug
|
|
database. You can submit your bug reports there. Please be as verbose
|
|
as possible - e.g. include the command line, if you use Windows or
|
|
Linux etc.pp. If at all possible please include sample files as well
|
|
so that I can reproduce the issue. If they are larger than 1M then
|
|
please upload them somewhere and post a link in the Anthill bug
|
|
report.
|