=================================================
Audio Overload - computer/console music player
Linux release 2.0b8 - September 15, 2007

Emulation core by Richard Bannister

Portions by R. Belmont, BouKiCHi, Fx3, Adam Bienias, 
Juergen Buchmueller, Jarek Burczynski, Julien Frelat, 
Benjamin Gerard, Shay Green, Charles MacDonald, 
Kerwin Medina, Mitsutaka Okazaki, Haruhiko Okumura, 
Tatsuyuki Satoh, Christian Scheurer, m_puusan, GORRY, 
smf, and the P.E.Op.S. team.

Linux port and GUI by R. Belmont
=================================================

What's this?
------------

Audio Overload is a player for various types of music files which you may
find on the Internet.

What's it play?
---------------

27 console and home computer file formats are now supported.

.AY   - Amstrad CPC/Spectrum ZX/Atari ST
.COP  - Sam Coupe
.GBS  - Nintendo Gameboy
.GSF  - Nintendo Gameboy Advance
.GYM  - Sega Megadrive/Genesis
.HES  - PC Engine
.IMF  - PC-compatibles, various Apogee games
.KSS  - MSX
.MDX  - Sharp X68000
.MOD  - Commodore Amiga
.NSF  - Nintendo NES
.NSFE - Nintendo NES (enhanced tags)
.ORC  - TRS-80 Orchestra-90
.PSF  - Sony PlayStation
.PSF2 - Sony PlayStation 2
.QSF  - Capcom QSound
.RAW  - PC-compatibles with an AdLib
.ROL  - PC-compatibles, AdLib Visual Composer
.S3M  - PC-compatibles with a GUS or SoundBlaster
.S98  - NEC PC-98
.SAP  - Atari XL/XE
.SCI  - PC-compatibles, various Sierra games
.SNDH - Atari ST
.SPC  - Super Nintendo
.VGM  - Sega Master System/Game Gear
.VTX  - Spectrum Vortex Tracker
.YM   - Amstrad CPC/Spectrum ZX/Atari ST

In addition, AO can find files of those types when they are inside a .zip,
.cab, or .rar container.

What's new?
-----------

- Various minor fixes.
- Preliminary support for PSF2 files.  Squaresoft games and games which
  don't synthesize music on the SPU2 (they just stream it) will not play.
  We know about it.  Don't bug us.
- Support for logging to WAV.
- Support for the jump to button.
- Support for muting individual channels.  The channel pane is always 
  visible and part of the main AO window.
- Fixed intermittent QSF failure, especially on 64-bit Linux
- Linux: scrollbars only appear in the song list when necessary


What's wrong with it?
---------------------

S3Ms with FM instruments don't work yet.  There's partial support in
the engine but not enough to make noise.

.GSF files may lose sync between the digital channels and the Game Boy
PSG after a while due to bugginess in the Boycott Advance core we use.


How to use?
-----------

Launch the ao application.  Click the "Open..." button to bring 
up a standard GTK+ open file dialog.  Choose a file of one of 
the types above or a .zip/.rar/.cab file containing files of those type(s).

You may remove a file from the list by clicking the "Delete item" button
while it's highlighted.

Unpacked files will appear by their filename in the list.  Files inside
a container (ZIP/RAR/CAB) will show the name of the container in parenthesis
after their name.  To play a file, simply double-click on it and it will 
start playing.  (You may also click the "Play" button for this).

To stop playback, click the Stop button (square icon).

If no song is currently playing, the Play button will become active
and you may click it to play whatever file is selected in the list.

Some filetypes (such as .NSF, .KSS, and .HES) contain multiple songs 
in each file.  If this is the case, the forward and back arrows will
become active when the song is playing and you may click the arrows to
navigate back and forth through the file.

To save a song to a WAV, click the "WAV..." button and pick a name.  The 
next time after that that you click "Play", "Jump to", track up, or track down
the logging will begin.  You can tell logging is active because an "L" will 
appear in the lower right of the oscilloscope area.  To stop logging, click
"Stop".


What's coming in the future?
----------------------------

[In general]
- The ability to save and load playlists will be added.
- Improved playback and more filetypes.  Suggestions are welcome on the
  official Audio Overload messageboard located at www.bannister.org.


Legal
-----
Copyright (c) 2001-2007 Richard Bannister.
Port code and GUI (c) 2005-2007 R. Belmont.  All rights reserved.
