mpv/TOOLS/README

581 lines
16 KiB
Plaintext

README for the TOOLS directory
==============================
Preamble
--------
In this directory you can find some nice scripts and code that makes
using MPlayer and MEncoder easier, for example scripts for DVD track
encoding in three pass mode or creating SVCDs from a movie.
FIXME: Document all the stuff in the subdirectories.
MPlayer scripts in the TOOLS dir
--------------------------------
midentify
Author: Tobias Diedrich
Description: Runs 'mplayer -identify' for all arguments while preventing
video window flashing.
Usage: midentify file1 [file2 ...]
mpconsole
Author: Rich Felker
Description: Script to run MPlayer on the console (fbdev/mga_vid/etc.) without
the console text and/or flashing cursor getting in the way.
Usage: mpconsole [mplayer options]
mplmult.sh
Author: Reimar Döffinger
Description: Example how to output video on multiple windows in sync. Might
be even more useful in combination with -vo ggi to distribute
the video arbitrarily.
Usage: mplmult.sh <n> <options>
n number of MPlayer instances that display the video
options any options you would pass to MPlayer, more than
one file will usually not work
subsearch.sh
Author: Alex Beregszaszi
Description: Collects subtitle files from the directory given as argument
('.' if none is given) and its subdirectories and prints
them as a comma separated list to stdout.
Usage: subsearch.sh [directory]
mplayer -sub `subsearch.sh` movie
x2mpsub.sh
Author: Gabucino
Description: Converts the subtitles in the current directory into MPsub
format (subtitles go in ./converted-subtitles/).
Usage: x2mpsub.sh
mp.pl
Author: Felix Bünemann
Description: Small helper script that allows to play multiple files with
MPlayer. Wildcards are supported.
Usage: mp.pl <parameters> <files>
Where <parameters> are all possible command line switches
for MPlayer and <files> can be either a list of files,
like file1 file2 file3 and/or a wildcard definition,
like *.avi.
example: mp.pl -vo x11 /dvd/VIDEO_TS/VTS_05_*.VOB movie.asf
wma2ogg.pl
Author: Peter Simon
Description: Converts WMA files to Ogg or MP3.
Usage: wma2ogg [options] <-f FILE1 | -f FILE2 ... | -a>
-f, -file filename
-a converts all WMA files in the current directory
-t output filetype (ogg, mp3) [default=ogg]
-lame I wanna use L.A.M.E. sure enough!
-br bitrate (kb/s) [default=from the WMA]
-del remove WMA file(s) after the transcoding
MEncoder scripts in the TOOLS dir
---------------------------------
divx2svcd
Author: Miklos Vajna
Description: A simple utility that creates an SVCD from a video in an AVI
container.
Usage: divx2svcd <input_avi> [options]
see 'divx2svcd -h' for more info
menc2pass
Author: Felix Bünemann
Description: Helper script to ease MEncoder two pass encoding. Give it all
the encoding parameters you would pass to mencoder, but leave
out the (v)pass=<n> suboption.
Usage: menc2pass <options>
mencvcd
Author: Jürgen Hammelmann
Description: Converts DVD (or anything else that MPlayer plays) to (S)VCD
Usage: mencvcd <basename> [mencvcd options] [mplayer options]
see 'mencvcd -h' for more info
Note: Requires MPlayer, mjpegtools, VCDImager, cdrdao, and optionally
LAME, tooLAME and SoX.
dvd2divxscript.pl
Author: Florian Schilhabel
Description: Yet another DVD to divx helper script.
This script encodes a DVD track in three pass mode to MPEG-4 with
libavcodec. Optionally it writes the resulting movie file to
CD-ROM the corresponding audio track to MP3. It can also shut
down the computer when it finishes. If you like, you can
watch the MEncoder output on /dev/tty8.
Usage: --help show help
--abr (AudioBitRate) Please enter the desired bitrate this
can be either [96|128|192] kbit/sec (default: 128).
--lang Specify the Language of the audio track this can be
for example <en> or <de> (default: <de>).
--dvd Specify the DVD track you want to encode.
--cdsize Specify the size of your CD-ROM (default: 700MB).
--shutdown Shutdown the system, when the encoding process has
finished. Needs appropriate privileges.
--out Specify the name of your encoded movie. The file
extension will be appended automatically.
--writecd Takes the newly created movie and writes it to a
CD-ROM.
--writedev cdrecord device identifier, for example 0,1,0
--speed writing speed (default: 4)
--dvd-device device to pull the video off (default: /dev/dvd)
aconvert
Author: Jonas Jermann
Description: A hack to allow MEncoder to read respectively encode from audio
only files.
Usage: aconvert <"input file"> <"output file"> <"options">
If no options are specified the following is assumed:
-oac lavc -lavcopts acodec=mp3:abitrate=192
Note: The script is probably bash dependent and it's just a quick
hack, feel free to improve it (or much better: fix mencoder ;).
qepdvcd.sh
Author: Reynaldo H. Verdejo Pinochet
Description: anything supported to VCD/SVCD PAL/NTSC converter
Usage: qepdvcd.sh file <options>
Run with no arguments to see the list of options.
Note: You will need vcdimager/cdrecord to master/burn the resulting
files.
Tech scripts in the TOOLS dir
-----------------------------
fastmem.sh
Author: Arpi
Description: benchmark/testbed for fastmemcpy stuff
Usage: fastmem.sh
sws-test
Author: Michael Niedermayer
Description: Very simple script to generate PNG images from a video with all
-sws methods.
Usage: sws-test <video-file> <start-pos> <res>
example: sws-test abc.avi 10 160:120
calcbpp.pl
Author: Moritz Bunkus
Description: A script that calculates the $bpp for a movie, mentioned in
DOCS/tech/encoding-tips.txt, see that document for more info.
Usage: calcbpp.pl <resolution> <aspect ratio> <bitrate> <fps>
resolution: the cropped but unscaled resolution
(use '-vf cropdetect')
aspect ratio: the encoded aspect ratio. All DVDs come at
720x576 but contain a flag that tells the player
wether it should display the DVD at an aspect
ratio of 4/3 (1.333) or at 16/9 (1.777). Have a
look at MPlayer's output - there's something
about 'prescaling'. That's what you are looking
for.
bitrate: the video bitrate in kbit/s
fps: the fps
example: calcbpp.pl 720x440 16/9 896 25
countquant.pl
Author: Moritz Bunkus
Description: Counts the quantizers used for the encoding, mentioned in
DOCS/tech/encoding-tips.txt, see that document for more info.
Usage: countquant.pl < divx2pass.log
It will print out which quantizer was used how often. If you see
that e.g. the lowest quantizer (vqmin=2) gets used for > 95% of
the frames then you can safely increase your picture size.
perlbench.pl
Author: Felix Bünemann
Description: fastmemcpy benchmark script
Usage: perlbench.pl
plotpsnr.pl
Author: Jonas Jermann
Description: Draw PSNR log graphs using gnuplot.
Usage: plotpsnr.pl [options] <file>
-h, --help Display this help message
-quant Display quantizers
-size Display size
-psnr Display PSNR
-iframes Display I-frames
-pframes Display P-frames
-bframes Display B-frames
-aframes Display all frames in different colors
-cmp <file2> Compare two files
-qs <style> Quantizer style
-ss <style> Size style
-ps <style> PSNR style
Default: -quant -size -psnr -qs "p" -ss "i" -ps "p"
Note: Requires gnuplot. Comparison is based on file2. Comparison
assumes that the frame numbers of both files fit.
psnr-video.sh
Author: Matthias Wieser
Description: Calculates the PSNR between two existing video files.
The PSNR is calculated frame by frame.
Also prints the overall PSNR.
The script can be used to:
* Compare different softwarescalers (should I use
-sws 1 or -sws 2 ?)
* Compare different resolutions (is it better to scale
down to 640x360 or to 560x320)
* Compare different deinterlacers
* Compare different video codecs
* Compare video filters (is it better to use -vf hqdn3d
or lavcopts:nr=400)
* [...]
Usage: psnr-video.sh <file1> <file2> [<frames>] [<options1>] [<options2>]
<file1> and <file2> are the video files for which the PSNR
should be calculated.
[<frames>] is the number of frames to process, starting
from frame 1.
[<options1>] are additional MPlayer options for <file1>
[<options2>] are additional MPlayer options for <file2>
A file called ./psnr.dat will be created with the following
content:
File;Y;Cb;Cr
00000001.ppm;34.23;39.54;40.06;35.426
00000002.ppm;33.03;38.71;39.26;34.271
00000003.ppm;33.45;38.91;39.28;34.655
00000004.ppm;32.72;38.69;38.85;33.972
[...]
00000247.ppm;35.55;40.84;42.15;36.785
PSNR:;35.9887
Note: This script relies on the the tool "pnmpsnr" for the
frame-by-frame PSNR calculation.
Be aware that psnr-video.sh needs a lot of temporary space
inside /temp/.
asfinfo
Author: Arpi
Description: a simple ASF header display program
Usage: asfinfo <filename.asf>
Note: Also see MPlayer's -identify option.
avi-fix
Author: Arpi
Description: A simple tool to fix chunk sizes in RIFF AVI files.
Usage: avi-fix [-fix] <badfile.avi>
Note: It does not check or fix the index, to do this use
'mencoder -forceidx -oac copy -ovc copy'.
bios2dump
Author: Nick Kurshev
Description: Extract your PC BIOS and save it to file.
Usage: As argument requires DOS interrupt number in hexadecimal form.
As output - will write 64KB file which will named:
SSSS_OOOO.intXX
where: SSSS - segment of BIOS interrupt handler
OOOO - offset of BIOS interrupt handler
XX - interrupt number which was passed as argument
checktree.sh
Author: Ivo van Poorten
Description: Check the source tree for anomalies.
Usage: checktree.sh -help
Note: This script is meant for developers to check the current (CVS)
source tree and/or the patches they are working on.
cpuinfo
Author: Jürgen Keil
Description: the prototype ../cpuinfo.c
Note: Used by configure to emulate /proc/cpuinfo on non-Linux systems.
dump_mp4
Author: Arpi
Description: MPEG4-ES stream inspector, dumps the stream startcodes.
fastmemcpybench
Author: Felix Bünemann
Description: benchmark/testbed for fastmemcpy stuff
Note: Also see fastmem.sh.
mem2dump
Author: Nick Kurshev
Description: Dump memory block to file.
Usage: As argument requires absolute address of memory dump and its
length (in hexadecimal form).
As output - will write file which will be named:
memADDR_LEN.dump
where: ADDR - given address of memory
LEN - given length of memory
movinfo
Author: Arpi
Description: Show QuickTime MOV file structure.
Usage: movinfo <filename.mov>
png2raw
Author: Arpi
Description: PNG to RAW image converter, used by .raw font creators.
Usage: png2raw <file1> [file2...]
vivodump
Author: Arpi
Description: Dump H.263 frame headers from VIVO files.
Usage: vivodump <input_file> <output_file>
Miscellaneous scripts in the TOOLS dir
--------------------------------------
subedit.pl
Author: Michael Klepikov
Description: A script for pipelined editing of subtitle files.
Usage: subedit.pl [switches]
-if,--input-format <fmt> input format; supported: SRT (default: SRT)
-of,--output-format <fmt> output format; supported: SRT
(default: input format)
-s,--shift <time> shift all subtitles by <time>
(format: [-]hh:mm:ss,fraction)
-c,--scale <time> scale by adding <time> to overall duration
-f,--split-from <time> drop subtitles that end before <time>
-t,--split-to <time> drop subtitles that start after <time> (will
truncate timing if it overlaps a boundary)
-r,--renumber renumber SRT subtitles in output
-d,--debug enable debug output
-h,--help help message
w32codec_dl.pl
Author: Tom Lees
Description: This script will use the Windows Media Player codec download
infrastructure to aquire the codecs listed in codecs.conf and put
them in a directory named "codecs/" below the current directory.
Usage: w32codec_dl.pl <codecs.conf location>
Note: You will need the libwww-perl stuff and the cabextract utility
which can be found at http://www.kyz.uklinux.net/cabextract.php3.
install-divx5.sh
Author: Andrea Menucci, thuglife
Description: Downloads and installs DivX 5 codecs from divx.com.
Usage: install-divx5.sh install
install-divx5.sh uninstall
install-w32codecs.sh
Author: Andrea Menucci, thuglife
Description: Downloads binary codecs from mplayerhq.hu and installs them
on a Debian system.
Usage: install-w32codecs.sh install
install-w32codecs.sh uninstall
vobshift.py
Author: Gábor Farkas
Description: Adjust the time-info in vobsub files
Usage: vobshift.py in.idx out.idx +8.3
Will shift the time by 8.3 seconds
subrip.c
Author: Kim Minh Kaplan
Description: Transform VOBsub subtitles into Subrip text subtitles using
GOCR/JOCR.
Usage: subrip <vobsub basename> [subid [output filename] ]
Note: Requires at least JOCR/GOCR 0.37.
You will have to change the 'vobsub_id' value if you want a
subtitle different from number 0. Hint: You can view the
subtitle that is being decoded with "display subtitle-*.pgm".
alaw-gen.c
Author: Arpi
Description: Generates alaw/ulaw tables.
Note: Created to work around a past license issue, no longer useful.
avisubdump.c
Author: Tobias Diedrich
Description: Dumps vobsub soft subtitles streams embedded in avi files.
Usage: avisubdump <avi>
Format conversion scripts in the TOOLS dir
------------------------------------------
302m_convert.c
Author: Reimar Döffinger
Description: Converts D-Cinema Audio (SMPTE 302M?) to WAV.
Usage: 302m_convert <in.302> <out.wav>
360m_convert.c
Author: Reimar Döffinger
Description: Converts D-Cinema Video (MPEG-2 in GXF, SMPTE 360M) to MPEG-ES.
Use -demuxer mpeges to play the converted file.
Usage: 360m_convert <in.gxf> <out.m2v>