Menu

Tree [485a85] master /
 History

HTTPS access


File Date Author Commit
 app 2010-10-27 Ahmad Ahmad [485a85] controllers can now cleanup too, updated TODO, ...
 config 2010-10-25 Ahmad Ahmad [f0977b] layout determined, UI functionality now complet...
 data 2010-10-26 Ahmad Ahmad [1eea28] now does a broken and dumb cleanup after organi...
 doc 2010-10-23 Ahmad Ahmad [df0cc4] library preferences now fully functional
 lib 2010-10-27 Ahmad Ahmad [485a85] controllers can now cleanup too, updated TODO, ...
 resources 2010-10-26 Ahmad Ahmad [b79d7f] renamed project to kaboomp3
 test 2010-10-27 Ahmad Ahmad [78286f] fixed some issues with track tag sanitizing
 CHANGELOG 2010-10-25 Ahmad Ahmad [7c617b] final layout for project.. renamed to kaBoom, c...
 KNOWN ISSUES 2010-10-25 Ahmad Ahmad [7fd65a] message boxes now inform the user of what might...
 LICENSE 2010-10-25 Ahmad Ahmad [7c617b] final layout for project.. renamed to kaBoom, c...
 README.markdown 2010-10-26 Ahmad Ahmad [8b6e1c] why isnt markdown working on gh...
 Rakefile 2010-10-26 Ahmad Ahmad [b79d7f] renamed project to kaboomp3
 TODO 2010-10-27 Ahmad Ahmad [485a85] controllers can now cleanup too, updated TODO, ...
 VERSION 2010-10-25 Ahmad Ahmad [7c617b] final layout for project.. renamed to kaBoom, c...
 kaboomp3.rb 2010-10-27 Ahmad Ahmad [485a85] controllers can now cleanup too, updated TODO, ...

Read Me

kaBOOM?

kaBoomp3 is a very simple tool that organizes your music library according to some options you can customize. For example, you can arrange your music directory to look something like this:

Library/Genres/Artists/Albums/Tracks

One very good use of kaBoomp3 is in sharing iPods; if you "rip", or copy the music contents of an iPod, they will be named cryptically, however, by allowing the application to organize it, you will have a tidy music library of your iPod music!

You're gonna blow my files up?

Well, contrary to what the name might imply, kaBoomp3 is very safe in running its business; it will show you a preview of all the changes before committing them. Only if you approve of the changes will it process your library.

What kind of music files can you organize?

Currently, supported music file formats are:

  • .mp3

Installing & Running

I plan to package the application and all its dependencies into a portable executable, which will include the Ruby interpreter, to save you the hassle of building the necessary dependencies. However, if for some reason you have/want to run it off the repository, here's what you need:

  • Qt 4.6.3 development libraries
  • qtruby gem (or qtbindings)
  • id3lib-ruby gem
  • active_record gem (will be removed in a later build)
  • sqlite3-ruby gem

To-do

  • add support for parsing other audio codecs
  • add a "Super/Sub Genres" sorting field, ie: Heavy Metal and Gothic Metal genres would fall under Metal genre
  • offer levels of organizing:
  • light: does not modify filenames or tags, only moves files around
  • normal: obeys user sorting preferences, renames known files and moves them according to their id3 tag
  • aggressive: attempts to correctly fill in missing id3 fields

Known Issues

  • corrupt MP3 files will cause the program to HANG; currently there's no workaround, as there is no way to validate a file for corruption and the parser gem (id3lib) does not crash or throw any exception, it just hangs indefinitely
  • UI: message box dialogues are confined to a small area
Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.