How to install and use
----------------------

asapconv::
{asapsetup%}Extract `asapconv.exe` to a directory of your choice
{asapsetup%}(for convenience, this directory should be included in your `Path` environment variable).
{asapsetup%}+
Run the program from command line to see the syntax.
The `-o`/`--output` option selects the output format and is mandatory.

WASAP::
{asapsetup%}Extract `wasap.exe` to a directory of your choice.
{asapsetup%}+
When you run WASAP, an "Open file" dialog appears. Simply select the file
you want to listen to. WASAP is later controlled by its tray icon.
When you hover the mouse pointer over the icon, the name of the loaded file appears.
To open another file, left-click the tray icon. The other options are
available in the menu which appears when you right-click the icon.

{asapsetup%}Apollo plugin::
{asapsetup%}Extract `ASAP_Apollo.dll` to the `Plug-ins` directory of your Apollo installation.

{asapsetup%}foobar2000 plugin::
{asapsetup%}Extract `foo_asap.dll` to the `components` directory of your foobar2000 installation.

{asapsetup%}GSPlayer plugin::
{asapsetup%}Put `gspasap.dll` in the directory which contains the GSPlayer executable.

Winamp plugin::
{asapsetup%}Extract `in_asap.dll` to the `Plugins` directory of your Winamp installation.
It is recommended that you remove other plugins that support Atari 8-bit music.

{asapsetup%}Windows Media Player plugin::
{asapsetup%}To install: extract `asap_dsf.dll`, `install_dsf.bat` and `uninstall_dsf.bat`
{asapsetup%}to a directory of your choice, then run `install_dsf.bat`.
{asapsetup%}+
{asapsetup%}To uninstall: run `uninstall_dsf.bat`, then delete the files.

XBMC plugin::
{asapsetup%}Put `xbmc_asap.dll` in the `system/players/paplayer` directory.
This DLL can be used with XBox and Windows versions of XBMC.
Your XBMC must include support for ASAP.

XMPlay plugin::
{asapsetup%}Extract `xmp-asap.dll` to your XMPlay directory.
{asapsetup%}+
If you want to use the "File information" window (to edit tags or convert between SAP and other formats),
assign a shortcut to it from XMPlay options.

{asapsetup%}DLL for Raster Music Tracker::
{asapsetup%}Extract `apokeysnd.dll` to the directory which contains `Rmt.exe`.

{asapsetup%}Audacious plugin::
{asapsetup%}Extract `asapplug.dll` to `lib/audacious/Input` inside the Audacious directory.

{asapsetup%}VLC plugin::
{asapsetup%}Extract `libasap_plugin.dll` to `plugins/demux` inside the VLC directory.
