Man Linux: Main Page and Category List

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>