Screenshot

What kind of narcissistic loser would post a screenshot of a cli app? Me, of course. Here's dir2ogg in action
Known bugs and Caveats:

BUGS
Sometimes the id3 tags will cause errors when passed to oggenc. At this point the error is trapped and the conversion is performed without writing the tags. Not sure what exactly what is causing this.

Older versions of dir2ogg do not check the exit status of mpg123 or faad. This means that if your mp3 or m4a is corrupted, or otherwise triggers an error it will NOT be handled. This is bad if you're using the -x or -a flag(s), because the original file will be deleted even though the conversion was not successful. This is fixed in versions 0.9pre1 and above.

Some special characters in filenames will break the script.

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.

Please send bug reports to this address.
Changes
0.9.2 :: December 15, 2005

This is 0.9.2_pre1 with a few minor fixes.
0.9.2_pre1 :: September 29, 2005

This is a testing release. It includes support for recursive directory conversion, and also support for embedded id3 tags in m4a files. Please beta test if you can. Barring a showstopper bug, this will be rolled out as dir2ogg 0.9.2.
0.9.1 :: April 1, 2005

This release allows multiple directories to be specified on the command line. Also, there is now support for the 'track number' id3 tag. It will show up as either '5' which shows track 5, or '5,17' which shows track 5 of 17 on the original album.
0.9 :: January 27, 2005

The changes between 0.9 and 0.9pre1 are trivial, so everything below applies to 0.9. To reiterate, your filename _may_ be changed, and error checking for mpg123, oggenc, and faad is included. Have fun!
0.9pre1 :: December 9, 2004

In dir2ogg 0.9pre1 the special characters '"', '*', '!', and ';' will be removed from filenames. The special character '&' will be converted to 'and'. These characters are known to break the script when fed to bash. If you don't like the idea of this script changing your filenames that's fair enough, but I submit these characters have no business being in proper unix filenames anyway. If I get the time I will try to change this so they are escaped rather than removed.

Also in this version, the exit status of mpg123, faad, and oggenc is checked, and should be handled apropriately. This means if you are using the 'x' or 'a' flags, your original file won't be deleted if mpg123 throws an error. Something you would expect of course, but with me it takes time for such 'features' ;)

And finally after two years I added some sanity checks on the filename/directory arguments passed to the script. So now if you mistype a filename you will get a stern warning about your file not being found from dir2ogg instead of a 50 line traceback from python.
0.8 :: September 27, 2004

dir2ogg 0.8 is pretty much a re-write from scratch. The original dir2ogg was not much more than an exercise for me. I was "scratching an itch" as ESR might say. I found myself converting mp3s to oggs quite frequently, and thought that others may be doing this as well, which is why I released dir2ogg in the first place. As my skill in Python increased, I added more features to dir2ogg...and the more I added to my original code the cruftier it got.

dir2ogg is now object-oriented instead of procedural. In addition to hundreds of unseen advantages, this will allow me to add new features in the future easily and cleanly. Along with a base of cleaner and more efficient code, dir2ogg 0.8 includes these benefits:

* Full support of GNU style short and long options.
* Ability to specify multiple filenames on the command line.
* In the absence of 'real' ID3 tags, scratch tags are created for all files.
* Coloured output to easily tell dir2ogg's output from oggenc's, faad's and mpg123's output.
* Many small bug-fixes.

0.8pre1 :: September 23, 2004

I am putting the finishing touches on a complete re-write of dir2ogg. Version 0.8 is going to be vastly superior to 0.7 for many reasons including full support for GNU-style long and short command line options, extensive exception handling, improved program logic, the ability to specify multiple files on the command line, and many, many more.
0.7 :: August 23, 2004

Version 0.7 has support for converting m4a and wav files to ogg format. To convert m4a files you will need faad installed. This version also fixes some bugs, including adding uppercase file extensions to the list of files to be converted ie: MP3, M4A, and WAV. Even if you don't intend to convert m4a files, you should still use this version.
0.6 :: May 24, 2004

This version introduces new command line flags. Deleting the .wav and .mp3 files is now user-controlled, there is an option to preserve the shell-protected filename, and there is also a verbose flag. Plus the '-dir' flag is now obsolete. Please us 'd' instead. NOTE: the new command line option flags do not need to be preceded by a dash. There cannot be any spaces between options on the command line. See Installation and Usage below...
0.5 :: May 14, 2004

dir2ogg 0.5 is in the Ibiblio Linux Archive.

dir2ogg now allows spaces in your filenames. The script uses sed to convert spaces to underscores, the conversion is made, then the underscores are reverted back to spaces. This is not fool-proof however...some special characters will cause the script to break. dir2ogg tries to deal with this gracefully, but I cannot anticipate every filename possible (there are some doozies when downloading mp3s from windows users ;)). Generally, if you use sensible filenames this will not be a problem for you. Keep in mind that you will still have to escape the filenames for bash ie: dir2ogg "song with spaces.mp3". Using "dir2ogg -dir ." will work fine however. Please read the updated manpage for more details.
0.4 :: October 8, 2003

I have bumped the version number up to 0.4 to reflect its 'stable' status. For almost everyone this is the version you will want to use. Also of note: dir2ogg is now a part of the Ibiblio Linux archive. It's home will always be this page, but my site is not always up...so you will always be able to get it from Ibiblio.
stats

It is Tuesday December 27, 2005 6:25 pm
This page served 26619 times
This page last modified: December 18, 2005 12:12 pm
Your IP address is: 209.237.238.172
You are browsing using: ia_archiver
You are browsing from: United States.
badcomputer.org's uptime: 18:25:08 up 39 days, 14:48, 1 user, load average: 0.00, 0.00, 0.00