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 the following tools: bmovl-test MPlayer scripts in the TOOLS dir -------------------------------- edgedetect.fp, emboss.fp Author: Reimar Döffinger Description: Examples of custom fragment program for OpenGL video out driver Usage: mplayer -vo gl:yuv=4:customprog=edgedetect.fp 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 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 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 [options] see 'divx2svcd -h' for more info mencvcd Author: Jürgen Hammelmann Description: Converts DVD (or anything else that MPlayer plays) to (S)VCD Usage: mencvcd [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 or (default: ). --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: converter from any supported format to VCD/SVCD PAL/NTSC Usage: qepdvcd.sh file Run with no arguments to see the list of options. Note: You will need vcdimager/cdrecord to master/burn the resulting files. encode2mpeglight Author: Giacomo Comes Description: Convert anything MPlayer can play to VCD/SVCD/DVD MPEG. Usage: encode2mpeglight -o -n [options] For help and documentation run: encode2mpeglight -h encode2mpeglight -l encode2mpeglight -doc Note: This script uses only MEncode/MPlayer. Check the final log file for informations/warnings about the encoding process. Tech scripts in the TOOLS dir ----------------------------- 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: 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. plotpsnr.pl Author: Jonas Jermann Description: Draw PSNR log graphs using gnuplot. Usage: plotpsnr.pl [options] -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 Compare two files -qs