Provided by: dir2ogg_0.11.8-1_all bug

NAME

       dir2ogg - Convert MP3, WAV, and M4A files to OGG format

SYNOPSIS

       dir2ogg  [  options  ] ( filename [filename2] ... || directory [directory2] ... || [cdrom-
       device] ... )

DESCRIPTION

       dir2ogg converts MP3, M4A, WMA and WAV files to the open-source OGG format. dir2ogg  is  a
       python script that simply binds together mpg123, faad, and oggenc making it easier for the
       user to convert his/her music files. OGGs are about 15 to  20  percent  smaller  than  MP3
       files, with the same relative audio quality. dir2ogg can be called with the -d flag at the
       command line to convert any number of directories at once, or given MP3, M4A, WMA,  and/or
       WAV  filenames as arguments, dir2ogg will convert only those files. If converting WAV, M4A
       or WMA files with -d you must add the -w, -m or -W command line flags respectively.  These
       flags  are  not neccesary unless using -d.  Note that converting M4A files requires you to
       have faad installed, and converting WMA files requires mplayer.

       Keep in mind that converting from MP3 or M4A to OGG is  a  conversion  between  two  lossy
       formats.  This  is  fine  if  you  just  want  to free up some disk space, but if you're a
       hard-core audiophile you may be disappointed.  I  really  can't  notice  a  difference  in
       quality with 'naked' ears myself.

   General Options
       -h or --help
              print quick usage details to the screen.

       -d or --directory
              convert  all  MP3  files  in directory. WAV and M4A files will be converted if used
              with the -w and -m command line flags. This option is  for  compatibility  purposes
              only and does not need to be specified anymore.

       -r or --recursive
              like -d but descends recursively into directories.

       -c or --cdda
              Convert  an audio CD into ogg. You may pass the device as an argument to the script
              (default: /dev/cdrom). Requires cdparanoia orq icedax or mplayer

       -p or --preserve-wav
              preserve all WAV files. By default they are deleted.

       -P or --no-pipe
              Do not use pipes to send data from the decoder to the encoder,  use  temporary  wav
              files instead.

       --delete-input
              Delete the input file after conversion

       -v or --verbose
              increase dir2ogg's verbosity.

       -Q or --quiet
              Do  not  display  progress messages, except the name of the file which is currently
              converted. Some decoders provide no way to disable  messages  and  thus  may  still
              display some.

   Conversion options
       --convert-all
              Convert  all  supported  audio files found in the directories given on the command-
              line to Ogg Vorbis.

       -f or --convert-ape
              Convert all APE (Monkey's Audio) files  found  in  the  directories  given  on  the
              command-line to Ogg Vorbis, using either ogg123 or flac or mplayer.

       -f or --convert-flac
              Convert  all  FLAC (Free Lossless Audio Codec) files found in the directories given
              on the command-line to Ogg Vorbis, using ogg123 or flac or mplayer.

       -m or --convert-m4a
              convert all M4A (MPEG-4 Audio) files found in the directories given on the command-
              line  to  Ogg  Vorbis,  using  faad  or mplayer. For decoding ALAC (Apple Lossless)
              files, 'alac-decoder' may be used.

       -m or --convert-mpc
              convert all MPC (MusePack) files found in the directories given on the command-line
              to Ogg Vorbis, using mpcdec or mplayer.

       -W or --convert-wma
              Convert  all  WMA (Windows Media Audio) files found in the directories given on the
              command-line to Ogg Vorbis, using mplayer.

       -w or --convert-wav
              Convert all WAV files found in the directories given on  the  command-line  to  Ogg
              Vorbis.

       -V or --convert-wv
              Convert  all  WV (WavPack) files found in the directories given on the command-line
              to Ogg Vorbis.

       -n or --no-mp3
              ingore all MP3 files found in directories given on the command-line.

       --(ape|cd|flac|m4a|mp3|mpc|wma|wv)-decoder=COMMAND
              Set the decoder you want to use for one filetype,  e.g.:  --mp3-decoder=lame.   Run
              dir2ogg --help to see the available decoders.

       -qN or --quality=N
              OGG  quality.  N  is a number between -1 and 10. Default is 3. Decimals are OK (ie:
              3.7)

       -t or --smart-mp3
              Try to use the same quality as the input file. MP3 input only!

SEE ALSO

       mpg123(1), mplayer(1), oggenc(1)

BUGS

       Enter you bug reports in Launchpad at https://bugs.launchpad.net/dir2ogg

AUTHORS

       0.10 and newer:  Julian Andres Klode <jak@jak-linux.org>
       0.9.3 and older: Darren Kirby <d@badcomputer.org>

CONTRIBUTORS

       original wma support: Cameron Stone <camerons@cse.unsw.edu.au>
       smart-mp3: Marek Palatinus <marek@palatinus.cz>