MadPlay GP32 v1.0
-----------------

This is the fourth public version of my MP3 player for the GP32.

The MP3 player which is part of the GP32 default firmware is just pants, only handling 128kps stereo bitrates, and very unresponsive. Since the main reason for me to listen to MP3 files is for the purpose of talking books, I need to seek backwards and forwards through running times of up to 30 minutes or more, otherwise I have to sit through the same crap over and over again just to hear the last 50 seconds of a chapter I nodded off during.

So you can already see that having to convert existing MP3 files to the right bitrate is a pain, and added to the lack of seeking functions, all before you consider the poor responsiveness of the built in player, is reason enough to write my own. Enter stage left, MadPlay GP32.

READ the known issues near the end of this file before you start using it!


Features
--------

Supports 22khz/44khz mono/stereo mp3 files (maybe more) of any bitrate.
Reads ID3 and ID3v2 tags
Seek backwards and forwards within an mp3 (once seek table is built)
Seek table progress indicator (faster the flash, closer to the end)
Scans all subdirectories under gp:\mp3\ for mp3 files and sorts by dir, then filename
Has a nice pretty interface
Built in attenuator (volume control)
Changed reboot buttons so as not to conflict with multifirmware after reset
Now plays 48khz, 44khz, 32khz, 24khz, 22khz, 16khz, 12khz, 11khz and 8khz mp3 files
Can now seek with shoulder buttons to jump to the start or end of an mp3
New options screen (using scrolling window for ultra funkyness)
7 Band graphic equaliser presets (note using the EQ will up the clock speed to 133Mhz)
Removed the caching of seek tables, seems silly and adds unneccessary clutter to the SMC
Change cpu clock rate between 66/133Mhz for faster seeking
Clipping protection (to avoid sound distortion when boosting volume with attenuation)
Key lock
Playlist screen showing current, preceeding and upcoming track data
Remove silence at start and end of mp3 files (ideal for badly encoded concert mp3s)
Sort playlist ascending or descending by album, title, filename or random shuffle
Save options on reboot
* GpDrive built in so now you can transfer mp3s from windows without leaving the player
* Scroll through playlist and select track
* Now saves currently playing track to the config file
* Help screen
* All graphics are now compressed for smaller executable
* Remembers seek tables of previous tracks in memory to save rescanning (memory limited)
* Semi-Keylock just disables track forward and backward, so most other features such as pause remain accessible
* Can now seek with by minutes with up and down 
* Can cancel seeking with the Start button
* Disabled seeking and pausing when overlapping to the next mp3
* Fixed seek table giving wrong track length bug
(* new for this version)


Installation
------------

Copy GPMADMP3.FXE to your gp:\gpmm\ directory, stick your mp3s in the gp:\\mp3\ directory (you can even use subdirs!). That's it for now!


Controls
--------

START			- Pause/Unpause
A + LEFT		- Seek backwards
A + RIGHT		- Seek forwards (only possible as far as the seek table pre-scan, patience young skywalker)
A + UP			- Seek backwards one minute at a time
A + DOWN		- Seek forwards one minute at a time (only possible as far as the seek table pre-scan)
A + LEFT SHOULDER	- Seek to start of mp3
A + RIGHT SHOULDER	- Seek to end of mp3 (only possible as far as the seek table pre-scan)
LEFT SHOULDER		- Previous track
RIGHT SHOULDER		- Next track
SELECT + LEFT SHOULDER	- Previous screen
SELECT + RIGHT SHOULDER	- Next screen
LEFT or RIGHT		- Toggle options in options screen, toggle graphic equaliser preset
UP or DOWN		- Select option in options screen, scroll through playlist
A			- Select new track in playlist
B + UP			- Volume up (to a maximum of +18db, will cause clipping if you go too high for an mp3)
B + DOWN		- Volume down (to a minimum of -30db)
B + LEFT		- Previous playlist sort type (only on playlist screen)
B + RIGHT		- Next playlist sort type (only on playlist screen)
A + B			- Keylock toggle (only on main screen)
A + START		- Cancel seek
B			- Help screen (hold down for 3 seconds)
START + BOTH SHOULDERS	- Reboot


Known Issues
------------

66Mhz mode plays audio back at 43457Hz whilst 133Mhz mode plays it at 43945Hz, not the ideal 44100Hz
Powering off the player when GpDrive mode is activated can leave your SMC in an undefined state
The config file from previous versions will be ignored and replaced on a reboot when upgrading to a new version


Credits
-------

Written by Robert J. Shepherd (that'll be me)
http://www.robertsworld.org.uk/gpmadmp3.html

Uses the libmad audio decoder software written by Robert Leslie.
http://www.underbit.com/products/mad/

I would not have been able to produce this software without the direct aid, advice and source code of Mr Spiv, Rob Leslie and Mr Mirko, the GPFont Maker and source by Oankali, GpDrive source provided by Squidge and DJWillis for his GCC help. Thanks guys you are all stars!
