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>
