ANDREW

andrew.sh − create AVI, Matroska or OGM files from DVDs

andrew.sh [-d file] [-i source] [-o destination] [-c container] [-m mode] [-s size] [-a encoding] [-A mode] [-q quality] [-Q quality] [-g volume] [-t tracks] [-l language[,language...]] [-T tracks] [-L language[,language...]] [-S directory] [-v encoding] [-f option[:option...]] [-F state] [-x option[:option...]] [-k seconds] [-r mode] [-ChV]

andrew.sh is Not a DVD Ripping and Encoding Wizard.

In fact it is an interactive command-line interface that simplifies the use of some applications to create AVI, Matroska or OGM files from DVDs.

-d file

Use the specified configuration file instead of the file ~/.andrew.conf.

-i source

Use the specified source instead of the one in the configuration file. Paths of both DVD reading devices (for "on-the-fly" encodings) and directories containing DVD mirrors are allowed. To mirror a DVD you can use, e.g., vobcopy(1): type ’vobcopy -m -i’ followed by the mount point of your DVD reading device.

-o destination

Use the specified destination directory for AVI, Matroska or OGM files instead of the one in the configuration file. If the specified destination directory does not exist or you aren’t allowed to write in it or there isn’t enough available disc space on the partition where it is, AVI, Matroska or OGM files will be moved in the directory where andrew.sh will have created its working directory. If the destination directory contains already files with the same name of new AVI, Matroska or OGM files, numbered backups of the old files will be made.

-c container

Use the specified container format instead of the one in the configuration file. Allowed formats are avi (AVI), mkv (Matroska) and ogm (OGM). If there is no AC-3 audio track in your DVD and lame(1) is not installed, andrew.sh will change avi into mkv.

-m mode

Use the specified mode to create files instead of the one in the configuration file. Allowed modes are cd (one or more files of the size you specified: every file ends when its last chapter ends), kbps (a single file with the video bit rate you will specify) and mb (a single file of the size you will specify). If the minimum number of parts is more than your source chapters or your source contains a single chapter or the maximum size is smaller than the size of a part or some parts are too short to be encoded with good results, andrew.sh will change cd into mb.

-s size

Use the specified size in MiB of a part instead of the one in the configuration file. Allowed values are integers between 1 and 1024 MiB.

-a encoding

Use the specified audio encoding instead of the one in the configuration file. Allowed encodings are ac3 (AC-3 extraction), mp3 (MP3 encoding) and ogg (Vorbis encoding). You can use MP3 encoding only in AVI files and only when lame(1) is installed, whereas Vorbis encoding only in Matroska and OGM files. If there is no AC-3 audio track, andrew.sh will change ac3 into mp3 or ogg. This option acts only as default when audio selection mode is manual.

-A mode

Use the specified audio selection mode instead of the one in the configuration file. Allowed modes are auto (andrew.sh will decide on the basis of the configuration files and the arguments of the options -a, -t and -l ) and manual (andrew.sh will show you a summary of DVD audio tracks followed by some questions). If there is only one audio track, container format is avi and lame(1) is not installed, andrew.sh will change manual into auto.

-q quality

Use the specified Vorbis audio encoding quality instead of the one in the configuration file. Allowed values are numbers between 0 and 9 (best quality). If the source is a 2 channel AC-3 stream and you’ve specified a value higher than 6, andrew.sh will set Vorbis audio encoding quality to 6.

-Q quality

Use the specified MP3 audio encoding quality instead of the one in the configuration file. Allowed values are integers between 0 (best quality) and 9. If the source is a 2 channel AC-3 stream and you’ve specified a value lower than 3, andrew.sh will set MP3 audio encoding quality to 3.

-g volume

Use the specified Vorbis audio volume gain, instead of the one in the configuration file. Allowed values are norm (normalisation) and integers between 0 (filter inactivated) and 60 dB.

-t tracks

Use the specified maximum number of audio tracks instead of the one in the configuration file. Allowed values are integers between 1 and 8. If the argument of the option -l or the corresponding value in the configuration file is all, andrew.sh will set the maximum number of audio tracks to 8. You can use only one AC-3 audio track in AVI files. You can’t use more than one audio track in AVI files without installing avimerge(1). This option acts only as default when audio selection mode is manual.

-l language,...

Use the specified languages for audio tracks instead of the ones in the configuration file. Allowed values are all (all the languages of your DVD audio tracks) or a coma-separated list of two small letter ISO 639-1 codes listed by the option -C, in decreasing order of preference. The list has to contain the languages allowed in the audio tracks of your AVI, Matroska or OGM files: if a language is missing from your DVD, it will be substituted by another one of your list until your list is over or your AVI, Matroska or OGM files contain the maximum number of audio tracks you specified. DVD audio tracks with invalid language codes will be ignored. If there are more than one DVD audio track with the same language code, only the first track will be encoded. If none of the specified languages is found, only one audio track containing the first alphabetical language of your DVD will be encoded; if the language code of that track isn’t valid, andrew.sh will ask you to specify the code. This option acts only as default when audio selection mode is manual.

-T tracks

Use the specified maximum number of VobSub subtitle tracks instead of the one in the configuration file. Allowed values are integers between 0 (no VobSub subtitle track) and 32. If the argument of the option -L or the corresponding value in the configuration file is all, andrew.sh will set the maximum number of VobSub tracks to 32. You can use VobSub subtitle tracks only in Matroska files.

-L language,...

Use the specified languages for VobSub subtitle tracks instead of the ones in the configuration file. Allowed values are all (all the languages of your DVD subtitle tracks) or a coma-separated list of two small letter ISO 639-1 codes listed by the option -C, in decreasing order of preference. The list has to contain the languages allowed in the VobSub subtitle tracks of your AVI, Matroska or OGM files: if a language is missing from your DVD, it will be substituted by another one of your list until your list is over or your AVI, Matroska or OGM files contain the maximum number of VobSub subtitle tracks you specified. DVD subtitle tracks with invalid language codes or with the same language codes of some SRT subtitle files will be ignored. If there are more than one DVD subtitle track with the same language code, andrew.sh will ask you to specify which one you want to encode.

-S directory

Use the specified SRT subtitle files directory. The SRT subtitle files must UTF-8 encoded and named xy.srt, where xy is a valid two small letter ISO 639-1 code listed by the option -C, and the subtitle timings have to be suited to the frame rate and relative to the whole DVD title where your movie is, even if you want to encode few chapters only. You can use SRT subtitle only in Matroska.

-v encoding

Use the specified video encoding instead of the one in the configuration file. Allowed encodings are fmp4 (MPEG-4 ASP from FFmpeg libavcodec) and xvid (XviD codec).

-f options

Use the specified FMP4 encoding options instead of the ones in the configuration file. Allowed options are the lavcopts specified by mplayer(1) except the following ones: abitrate, aspect, autoaspect, bit_exac, keyint, ildc, ildme, lmin, lmax, mbqmin, mbqmax, qpel, vbitrate, vcodec, vqmax, vqmin, vqscale, vpass, vratetol, vrc_maxrate, vrc_minrate and vrc_override. The default options are not suited to animations: mbd=2:trell:cbp:v4mv:precmp=1:cmp=1:subcmp=1 should be better. Add threads=2 if you want take advantages of your dual-processor or dual-core system.

-F state

Use the specified FMP4 compatibility state instead of the one in the configuration file. Allowed states are on and off. If container format is avi and FMP4 compatibility is turned on, andrew.sh will strip off autoaspect, mv0 and v4mv encoding options and set xvid FourCC in order to avoid problems with some cheap or old stand-alone divx players.

-x options

Use the specified XviD encoding options instead of the ones in the configuration file. Allowed options are the xvidencopts specified by mplayer(1) except the following ones: 4mv, aspect, autoaspect, bitrate, container_frame_overhead, fixed_quant, interlacing, max_bquant, max_iquant, max_key_interval, max_pquant, min_bquant, min_iquant, min_key_interval, min_pquant, mod_quant, mpeg_quant, pass, qpel, quant_inter_matrix, quant_intra_matrix, quant_range.

-k seconds

Use the specified seconds per key frame instead of the ones in the configuration file. Allowed values are integers between 0 (every frame will be a key frame) and 10. Low values entail low video quality, high values and 0 inaccurate searching.

-r mode

Use the specified video resolution mode instead of the one in the configuration file. Allowed modes are auto (automatic scaling), bpp (scaling on the bit per pixel per frame you will specify), max (no scaling), and multiples of 16 between 512 and 576 (scaling on the horizontal resolution specified). If DVD horizontal resolution is 352 or 480, andrew.sh will set resolution mode to max.

-C

List ISO 639-1 and 639-2/T codes for representation of languages and exit (with success).

-h

Display the help and exit (with success).

-V

Output version information and exit (with success).

After having been invoked, andrew.sh demands simply that you reply the asked questions. There are some answers that cause a special behaviour:

w

Display the sections of the GNU General Public Licence about warranty.

c

Display the GNU General Public Licence from section 1.

h

Display further explanations about the asked question.

q

Quit.

Before the last question andrew.sh shows you a summary. Text styles and colours have different meanings:

bold

Values from your configuration file or from command line options.

blue

Values from your answers.

green

Approximated values.

At the end of its job andrew.sh shows you some information, in particular the mean quantizer with its standard deviation, relative to the video encoding first pass, and the overhead, the ratio between the AVI, Matroska or OGM file size and the data size.

~/.andrew.conf

Configuration file. It’s created at the first start.

LC_MESSAGE variable determines andrew.sh language. If the respective language doesn’t exist, andrew.sh language will be English.

PWD variable determines where andrew.sh will create its working directory. If you aren’t allowed to write in the current directory, andrew.sh will create its working directory in your HOME directory.

If andrew.sh working directory is on a filesystem that doesn’t support named pipes, Vorbis audio encoding will not be "on-the-fly", but first a raw PCM audio track will be encoded.

The following exit state are returned because of errors displayed on stderr:

64

The option is not allowed by andrew.sh or misses its argument or the argument is not allowed by the option.

69

The listed programs are missing in the path specified by PATH variable or you aren’t allowed to execute them.

70

andrew.sh was terminated by SIGINT or SIGTERM.

Alessandro Di Rubbo <andrew@tobemem.memebot.com>

mplayer(1), vobcopy(1).