NAME

       tablet-encode - video converter for Nokia Internet Tablets

SYNOPSIS

       tablet-encode [options] input destination
       tablet-encode [options] input [input2...] directory
       tablet-encode [options] --list input [input2...]

OPTIONS

       -g, --gui open a graphical interface to tablet-encode

       -q, --quiet
              be vewwy vewwy quiet

       -p, --preset=PRESET
              preset to use. Use --preset=list to see them all

       --hq   high quality encoding (takes longer).

       -s, --sample=SECS
              produce a SECS second sample encoding. Default: 30

       -i, --index
              generate avi file index

       -i, --index
              include material from `FILE'

       -7, --770
              use a different FOURCC for better 770 compatibility

       -o, --original-aspect
              disable cropping image to better fit screen

       -c, --copy-audio
              copy the existing audio track

       -2, --two-pass
              encode in two passes for better quality

       -m, --mencoder=ARGn
              pass ARGn to mencoder (can occur multiple times)

       -t, --subtitle=FILE
              embed subtitles in the converted video, from the specified file, or <file>.srt

       -e, --episodes
              when auto-detecting DVD track, rip all episodes

       -l, --list
              specify  that  the  arguments  are  a list of files to encode, output file is input
              suffixed with preset

       -h, --help
              print this help, then exit

DESCRIPTION

       There are a number of different ways of using tablet-encode, but the simplest is  to  give
       one existing movie (or URL) and the filename of the target:

           tablet-encode input.avi output.avi
           tablet-encode http://www.example.com/somefilm.mov output.avi
           tablet-encode dvd://1 output.avi

       The  last  of  these  has  shown MPlayer's support for DVDs. tablet-encode will also auto-
       detect directories containing VIDEO_TS folders as DVDs, and if the title  on  the  DVD  is
       unspecified, the longest will be used:

           tablet-encode dvd: output.avi
           tablet-encode /media/dvd/ output.avi

       For  TV  series'  DVDs, the '--episodes' option can be used. This will rip all episodes on
       the DVD within 10% of the middle-longest track (i.e. the median):

           tablet-encode --episodes dvd: /media/nokia-external/Video/

       A number of presets are available. If none is specified, it defaults to "average". A  full
       list of the presets can be seen by passing `list' to the --preset option:

           tablet-encode --preset list

       If the target of the encoding is a directory, multiple input files can be specified:

           tablet-encode file1.avi file2.mov file3.wmv  output/

       There are many more options, a full listing is provided in the online help:

           tablet-encode --help

       Running  tablet-encode  with  no  parameters  will start a GUI version, if possible. A GUI
       progress bar can be shown when specifying arguments with the `--gui' option. This requires
       the Gtk2-Perl bindings to be installed.

CONFIGURING

       The  file `.tablet-encode.conf' will be read from your home directory at start up. In this
       file you can define your own presets, change the default preset used if none is  specified
       and a few other things.

       To  define  your  own  preset,  say  "dvd", create ~/.tablet-encode.conf in your favourite
       editor and add the content:

           $PRESET{dvd} = { abitrate => 256, vbitrate => 800, width => 400 };

       This will define a preset called 'dvd' with an audio bitrate of 256kbps, a  video  bitrate
       of  800kbps  and a maximum width of 400 pixels. The height is auto-calculated based on the
       tablet's screen and the size of the input video.

       To use the 'dvd' preset instead  of  'average'  when  no  preset  is  specified,  add  the
       following line to ~/.tablet-encode.conf:

           $defaultPreset = 'dvd';

       Note  that  this  is  a  mini-Perl  script,  so blank lines and lines starting `#' will be
       ignored. All statements MUST end in a semi-colon, `;'.

       For Nokia 770 users, you may wish to always use 770-compatibility mode. To  achieve  this,
       in ~/.tablet-encode.conf put:

           $options{770} = 1;

AUTHOR

       tablet-encode was written by Andrew Flegg <andrew@bleb.org>.

       This  manual  page  was written by Alessio Treglia <quadrispro@ubuntu.com>, for the Ubuntu
       project (and may be used by others).

                                        December 15, 2009                        TABLET-ENCODE(1)