README for the TOOLS directory
=============================

1. 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 3-pass mode or creating SVCDs from a movie.

2. Shell scripts in TOOLS dir
------------------------------

2.1 divx2svcd
	Author:		VMiklos
	Description:	A simple utility that creates a SVCD from a video in an
			AVI container
	Usage:		divx2svcd input_avi [options]
			see divx2svcd -h for more info

2.2 fastmem.sh
	Author:		Probably A'rpi
	Description:	benchmark/testbed for fastmemcpy stuff
	Usage:		./fastmem.sh

2.3 mencvcd
	Author:		Jürgen Hammelmann
	Description:	Converts MPlayer Sources (DVD) 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.
2.4 midentify
	Author:		ranma (full name?)
	Desctiption:	Runs mplayer -identify for all arguments while prevents
			vo window flashing.
	Usage:		./midentify file1 [file2 ...]
2.5 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]
2.6 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 mplayer-opts
			n		number of MPlayer instances that display
					the video
			mplayer-opts	anything you would specify to mplayer,
					more than one file will usually not work
2.7 sws-test
	Author:		Michael Niedermayer
	Description:	Very simple script to generate png images from an video
			with all -sws methods.
	Usage:		sws-test <video-file> <start-pos> <res>
			example: sws-test abc.avi 10 160:120

2.8 x2mpsub.sh
	Author:		Gabucino
	Description:	Converts the subtitles in the current directory into
			MPsub format (into ./converted-subtitles/*)
	Usage:		./x2mpsub.sh
	

3. Perl scripts in TOOLS dir
----------------------------

(...)

4. C codes in TOOLS dir
-----------------------

(...)

5. the GL-test dir
------------------

(...)