QtOIDUA

There is no formal documentation for QtOIDUA at this time. If you've used OIDUA before, then using QtOIDUA should be a breeze. If not, it is fairly self-explanatory.

I realize that doesn't quite cut it, and so I hope to have something better here in the near future. In the meantime, here is a small collection of miscellaneous information.

ChangeLog

The latest ChangeLog is available here.

Compiling in Linux

Compiling QtOIDUA in Linux is fairly straightforward. Simply extract the tarball, travel to the newly created qtoidua-x.xx directory, and run "qmake qtoidua.pro && make". QtOIDUA requires the Qt 3.3 development libraries to compile. It is not compatible with Qt 4 at this time.

The resulting binary will be in the bin directory. You can execute the program from there, or move it anywhere you'd like (/usr/local/bin, for example).

Compiling in OS X

There are no longer any extra steps to compile QtOIDUA in Mac OS X!

Although it is not necessary, if you wish to compile QtOIDUA in OS X yourself (to use your own Qt libraries that you have compiled and installed, for example), this can be done by downloading the Linux source tarball and following the same directions. Remember that compiling QtOIDUA in OS X requires Qt 3.3. It is not compatible with Qt 4 at this time.

When QtOIDUA has finished compiling, QtOIDUA.app will be created in the bin directory. Simply drag it to Applications to install.

Settings

QtOIDUA stores some settings on your system, such as the location of OIDUA.

When specifying the location of OIDUA, be sure to point to the OIDUA executable. It is typically named oidua.py, but may be different if you installed OIDUA from a package.

LINUX: QtOIDUA's settings are stored in the ~/.qtoidua/ directory.

OS X: QtOIDUA's settings are stored in /Volumes/$VOLUME/Library/Preferences/com.spoonfedmonkey.qtoidua.plist.

QtOIDUA File Format

The structure of the files QtOIDUA uses is very simple. They are just plaintext files that hold one piece of data per line. For those interested, they are stored like this:

     QtOIDUA Version
     Output File
     Number of Include Directories
     [Include Directories] *
     Number of Exclude Directories
     [Exclude Directories] *
     Number of Fields
     [Fields] *
     Display Datestamp Header **
     Display Elapsed Time **
     Display Statistics **
     Display Version **
     Skip Files That Cause Audiolist Failure **
     Case Insensitive Sorting **
     Expand Wildcards **
     Strip Output **
     Indent **
     Indent Size
     HTML Output **
     HTML Background
     HTML Foreground
     Merge Identical Directories **
     Save in output.db Format **
     Exclude MP3s with no LAME Profile **
     Exclude MP3s with Constant Bitrates **
     ID3 Tag Version Preference (1 or 2)

* Skipped if previous value is 0.
** Checkbox values are represented with a 0 or 1.