diff --git a/TOOLS/README b/TOOLS/README new file mode 100644 index 0000000000..91f9ca1482 --- /dev/null +++ b/TOOLS/README @@ -0,0 +1,404 @@ +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. + +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 number of MPlayer instances that display the video + options any options you would pass to MPlayer, more than + one file will usually not work + + +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 + Where are all possible command line switches + for MPlayer and 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 [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) + + + +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 + + 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: 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] + -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