3gpwiz is a small perl/kommander script that helps the user convert 
almost any movie type to a format suitable for watching on the modern 
mobile phones (3gp/mp4). It is written to be as simple as possible 
while still providing very advanced features - subtitle support, video 
(picture) equalizer and a full mplayer filter support.


REQUIREMENTS

perl
kommander
mplayer (tested with the latest CVS version!)
faac (optional - neaded for the AAC audio)
ffmpeg with AMR (and optional AAC) support


HOW TO INSTALL FFMPEG WITH THE AMR AND AAC SUPPORT?

If you have a mobile phone that can handle AAC audio, make shure that 
you first install the faac library together with it's development 
package (faac, libfaac0 and libfaac0-dev on debian/ubuntu).

Method 1: GUI INSTALL

Run 3gpwiz and go to the Setup tab. There click on the 'Install'. First 
make shure that you are connected to the internet as the script has to
download about 1MB of source code.

Method 2: MANUAL INSTALL (OLD)

I wrote a script that will(should) download, compile and install the 
latest cvs ffmpeg with AMR patches (FAAC you have to install by 
yourself, before running this script).
Run the script as root: ./install-ffmpeg
If you want the AAC support: ./install-ffmpeg --enable-faac

The script will by default download the source to /usr/src/ffmpeg and 
install the compiled ffmpeg executable to /usr/local/bin/ffmpeg. If 
you would like to change the default paths, edit the script.
Please edit the 3gpwiz perl script and change the $ffmpeg variable to 
point to the just installed ffmpeg executable!


HOW TO INSTALL?

If your mobile phone supports the maximal 3gp video size other then the 
default 176x144, please edit the 3gpwiz script and change the $SW and $SH 
variables (on the top of the file). 
As root, run ./install


HOW TO RUN?

1) From a commandline: 3gpwiz [filename]
2) From Konqueror servicemenu (right click on a movie file)

From a Konqueror menu you can select either 'convert to 3gp/mp4' (full
GUI with all option access) or 'quick convert to 3gp/mp4' that does a
quick, noninteractive background convert using the options from the last
GUI run. Quick convert also supports multifile selections (you select
multiple files in the Konqueror and then batch-convert them using 'quick
convert'). Conversion with 'quick convert' is also much faster for 
smaller files then the conversion with the full GUI.
If you want to 'quick convert' from a terminal (no X access neaded), just
add a '-q' after the filename:
3gpwiz filename -q


GETTING HELP

Read the tooltips (long hoover over the item) and "What's this?" (right 
click on the item).


HOW TO ENCODE A DVD?

Start the 3gpwiz from a terminal with the syntax:
3gpwiz dvd://title
(for example, dvd://1)


AUTHOR: Domjan Svilkovic <dsvilko@gmail.com>
Feel free to contact me if you have any comments or bug reports.
