
  R o x D A O
  ~~~~~~~~~~~
  By Jonatan Liljedahl - http://kymatica.com

  
WHAT IS THIS?
~~~~~~~~~~~~~
RoxDAO is a graphical frontend to cdrdao for the ROX Desktop.

RoxDAO provides an easy to use interface for composing audio CDR's and
burning them in disc-at-once mode.

One track can consist of one or several blocks which each can be one
audio file, a part of an audio file, or silence. RoxDAO lets you add and
remove blocks, move the order of blocks, and toggle trackmarks.


FUNCTION
~~~~~~~~
Drag .wav or raw audio files from a filer window and drop them on the
main area to add them. You can move the order by dragging them around.

RoxDAO can load and save .toc files, (cdrdao's description files).
Drop .toc files to append them to your project. 

If you drag .mp3 or .ogg files, it will try to convert them to .wav first
with the Mp3Ogg2Wav utility, 
see the end of this README for details.

It's possible to drag blocks between RoxDAO applications

Click on the "silence" button on the toolbar to add silence, or drag the
button to a block to insert silence.

Left-click on a block to select it,
Right-click to toggle trackmark on/off,
Middle-click to set cursor to start of block.

Click in the area above the blocks to move the cursor,
Right-click to center the viewport around the cursor.

The scroll-wheel zooms in/out

The Start, End or Length entries in the "selected block" frame
is editable.


BURNING
~~~~~~~
RoxDAO provides a progress bar and logwindow to monitor the
burningprocess.

NOTE: It's the saved (or loaded) .toc that gets burned, if you change
anything make sure you save it again before burning!

Be sure to edit the Settings (Click the "settings" button on the
toolbar), and fill in the options before you burn anything.

By default, simulate-mode is enabled, which means that you'll have to
uncheck this checkbox in Settings to actually enable real burning. 

Set Speed to 0 to get maximum writing speed.
If you set a high speed and have a slow machine, chances are that your
CD-Recorder is so fast that the logwindow and progress bar won't catch
up with the process... 

See the manpages on cdrdao for details about the available settings.


Built in audio player
~~~~~~~~~~~~~~~~~~~~~
RoxDAO features a simple audio player.
You'll need libao and pyao to enable this...
Both are available form http://www.vorbis.com/download.psp


MP3 and OGG decoding
~~~~~~~~~~~~~~~~~~~~
RoxDAO will try to convert any .mp3 and .ogg files to .wav with the
Mp3Ogg2Wav utility, available at http://kymatica.com/software.html

You can set the full path in settings, or leave blank to search for it
in the same directory where you installed RoxDAO. You can also enter
another decoder utility,  but you'll have to make sure that it behaves
like this:

* It must take a list of .mp3 and .ogg files as cmdline arguments
* It must convert each of them to 16Bit 44.1KHz Stereo WAV's
* Each converted file must be put in the same directory as the source file,
  and have the same basename but '.wav' as extension name.
