=================================================
Audio Overload - computer/console music player
Linux release 2.0b9 - December 16, 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?
---------------

32 console and home computer file formats are now supported.

.AHX  - Commodore Amiga
.AY   - Amstrad CPC/Spectrum ZX/Atari ST
.COP  - Sam Coupe (also found as .SAA sometimes)
.GBS  - Nintendo Gameboy
.GSF  - Nintendo Gameboy Advance
.GYM  - Sega Megadrive/Genesis
.HES  - PC Engine
.HVT  - Commodore Amiga
.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 (also the related .MYM and .X1F formats)
.SAP  - Atari XL/XE
.SC68 - Atari ST and Amiga (this file format can contain many other types)
.SCI  - PC-compatibles, various Sierra games
.SNDH - Atari ST
.SPC  - Super Nintendo
.SPU  - Sony PlayStation
.VGM  - Sega Master System/Game Gear
.VTX  - Spectrum Vortex Tracker
.WSR  - Bandai WonderSwan/WonderSwan Color
.YM   - Amstrad CPC/Spectrum ZX/Atari ST

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

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

Since b8:

- New .SSF Sega Saturn/ST-V format supported
- New .WSR WonderSwan format supported
- Fixed Linux song list to no longer be weirdly double-spaced
- Fixed issues with some SNDH/SC68 files
- Automatically advances to next song when end detected
- Experimental Win64 version for 64-bit XP and Vista
- Completely new .S98 engine with much better compatibility
- New .SPU (Sony Playstation logs from the Eternal SPU plugin) support
- 7zip container support
- Shift-JIS Japanese characters are now converted for proper display.
- New AHX / HVT support
- Greatly expanded .SC68 support - now over 50 subformats work including Future Composer and SIDMON
- Rewrote timing emulation for PSF/PSF2 files


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.
