Status License Language Launchpad VCS Latest release
Maintenance GPL-2+ Python dir2ogg Bazaar@LP dir2ogg-0.11.8.tar.gz (GPG, Aug 2009)

dir2ogg is a GPL'ed python script which converts mp3, m4a, wma, and wav files into ogg-vorbis format. It can preserve tags found in the input file where supported. It was inspired by the perl script mp32ogg, but supports much more features these days. dir2ogg is supported in maintenance mode, meaning that it will not receive new features, but only bugfixes (unless someone writes patches for new formats). If you want to submit a patch or report a bug, please do so in the bug tracker at launchpad.net.

Downloads

The current stable release is 0.11.8 (NEWS). It is recommended that you install and use this version. If you need an older version of dir2ogg, you may want to visit the directories of the relevant release series: 0.10, 0.11.

Installation

Users running Debian, Gentoo or Ubuntu can install the software using their standard package managment solution. Ubuntu users need to enable the universe component.

Users running other distributions may need to manually install it, probably like this:

$ tar xzf dir2ogg-0.11.8.tar.gz
$ cd dir2ogg-0.11.8
$ sudo sh ./install.sh              # or simply run dir2ogg via ./dir2ogg

Dependencies

Format Recommended Alternatives
APE (Monkey's Audio) mac mplayer
MP3 mpg321 mpg123,lame,mplayer
MP4/M4A/AAC faad alac-decoder (for ALAC files), mplayer
FLAC flac ogg123 (included in vorbis-tools), mplayer
MPC (Musepack) mpcdec mplayer
WMA/ASF mplayer
WV (WavPack) wvunpack mplayer
Audio-CD cdparanoia icedax, cdda2wav, mplayer

Usage

These are some examples. For more information, read the manual page.

Convert files

$ dir2ogg foo.mp3 # one file...
$ dir2ogg -t foo.mp3 # one file (keep quality, only for mp3)...
$ dir2ogg foo.mp3 bar.m4a baz.wma qux.wav # multiple files...

Converting directories

$ dir2ogg -d /path/to/mp3directory # single directory...
$ dir2ogg /path/to/mp3directory # single directory..., same as previous one.
$ dir2ogg -r /path/to/mp3directory # single directory (and subdirs)...
$ dir2ogg -d /path/1/ /path/2 /path/3 # multiple directories...
$ dir2ogg -r /path/1/ /path/2 /path/3 # recursive...

Warning

"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. You might want to do your conversion, then compare with the original before erasing them." - Darren Kirby, initial dir2ogg developer