ST-Sound GP2X v0.3b2
====================

ST-Sound GP2X is a YM/SC68/SNDH music player for the GP2X. It uses the STSound
library from Arnaud Carre (http://leonard.oxg.free.fr) for playing YM files and
the SC68 library for playing SC68 and SNDH files (http://sc68.atari.org). The
GUI is based on Aylet.gp2x by ParkyDR.


Install
=======

Extract the archive and copy the directory anywhere on your SD card. Create a
directory on the SD card to hold your Atari ST music. Edit the STSoundGP2X.gpe 
script and change the YM68_DATA variable to your music directory. By default
the 'samples' directory is used as music directory.


Run
===

Navigate to the stsound-gp2x-x.x directory using the 'Games' menu and select 
STSoundGP2X. 


Problems
========

Most audio problems are related to the buffer size and frame delay. If a tune
doesn't sound correct, try modifying these parameters. Generally, increasing
the buffer size and frame delay will improve playback. These parameters are
set using commandline options (see below).


Controls
========

Joystick UP/DOWN	- Select tune from playlist
Joystick LEFT/RIGHT	- Change track (SC68/SNDH), fast forward / rewind (YM)
A			- Pause
B			- Play selected tune
L			- Toggle looping on / off
R			- Toggle playlist mode on / off
Volume +/-		- Change playback (software) volume
Select			- Toggle between playlist / help screen
Start			- Quit


Commandline Usage
=================

Usage: ym68sdl.x86 [OPTIONS] PATH

Where options include:
  -b       sample buffer size [1024-16384]
  -v       initial playback volume [0-128]
  -y       initial ym playback volume [0-128]
  -f       frame delay in ms [0-500]
  -h       display this help screen and exit

PATH specifies where to look for music files.


Contact
=======

bja@kth.se
