
>>>> GAME MUSIC GEAR MX

>> INTRO 

>  GameMusicGear~MX is an upgrade from the old GameMusicGear.
   It's a multiformat music player designed with video game
   music in mind.

>  It's based on some popular multiformat players like 
   the xmms, winamp and mostly oldplay for the gp32.
   

>> FEATURES

>  GMG_MX uses a new plugin system.  There are three types of 
   plugins.  Input Plugins for audio decoding (like mp3 plugin, 
   spc plugin, etc), Output Plugins to encode audio to another
   format, and the Visual Plugins for music visualization, lyrics 
   display, etc. Very similar to the winamp plugins.
   
   Each plugin consist of a config file (.plugin) and a module
   file (.prx).  And can be replaced or removed if you want to 
   upgrade or disable a plugin.
   
>  Custom Skin Support - Please read the skins.README and see the skins found 
   in the skins folder if you want to make a new one.
   
>  Mini Visualizer - There are two mini visualizers available, spectrum
   and wave, inspired by the ones found in winamp.
   
>  Chinnese GBK, BMP, TrueType and pgf font support, with LATIN and UTF8 support.

>  Zip, Rar, 7zip and gzip files support through the File_Extractor library by
   Shay Green.  Rar and 7zip support is only available on the PSP Slim due
   to memory requirements.

>  In game configuration screen.

>  Control keys configuration - You can configure it through the 
   config menu, or you can do it manually editing the 'keys' file.
   
>  Three levels of audio output amplification, configured in  
   each plugin config file.  Since version 1.3 this levels are fixed
   to +3, +6 and +9 dB.
   
>  Built in 10 Band Real Time Equalizer with presets support.
   
   
>> CONTROLS CONFIGURATION

This is the default controls configuration.
Note: Since Version 1.0 there are some changes in the app's behavior with 
      the addition of a separate file browser. 
	  Since the file browser uses fixed control keys, there are some
	  restrictions in the control configurations.

ACTION								BUTTONS
------------------------------------------------------
Enter folder / Play song 			PSP_CTRL_CIRCLE
Go to first entry 					DISABLED   (Disabled since browsing page up/down
											    is quite fast)
Browse to previous entry 		    PSP_CTRL_UP
Browse to next entry				PSP_CTRL_DOWN
Browse to previous page				PSP_CTRL_CROSS+PSP_CTRL_UP
Browse to next page					PSP_CTRL_CROSS+PSP_CTRL_DOWN
Fast-forward song					PSP_CTRL_RIGHT
Rewind song							PSP_CTRL_LEFT
Stop playback						DISABLED  (I really don't find it useful)
Pause / Resume playback				PSP_CTRL_START
Play next subtune					DISABLED  (By default subtunes are changed 
											   with the prev/next song command)
Play prev subtune					DISABLED
Increase audio level				PSP_CTRL_CROSS+PSP_ANALOG_UP
Decrease audio level				PSP_CTRL_CROSS+PSP_ANALOG_DOWN
Take a screenshot					DISABLED  (Disabled for now)
Switch to fullscreen visualizer		PSP_CTRL_TRIANGLE
Change visualizer					PSP_CTRL_SQUARE
Enter setup screen					PSP_CTRL_SELECT
Change playmode						PSP_CTRL_CROSS+PSP_CTRL_SQUARE
Play next song						PSP_CTRL_RTRIGGER
Play previous song					PSP_CTRL_LTRIGGER
Enter equalizer setup				PSP_CTRL_NOTE
Enter browser screen				PSP_CTRL_SQUARE
Exit app							PSP_CTRL_HOME

>> INSTALL

To install simply copy the GMGearMX folder to the GAME folder of your
psp.  some plugins need additional files in order to work, please read the
plugin.readme file for details.

Note: There will be no 1.5 kernel support :(, since i don't have a PSP Fat
	  anymore.

>> TODO

*   Please read the TODO file.

>> INPUT FORMATS COMPATIBILITY:
>> OUTPUT FORMATS COMPATIBILITY:
>> VISUAL PLUGINS 

* Please read the plugin.readme file.


>> CREDITS

*   First i would like to thank all the people who made psp homebrew 
    posible.  (And of course to Sony for making a great device like the
	psp).
	
*   GameMusicGear~MX is powered by:
	- JGE++ (Jas Game Engine++), a very 
      nice game engine by jhkhui.  
      http://code.google.com/p/jge	
	- IntraFont by BenHur
	- File_Extractor library by Shay Green
	
*   Programmer: gama (aka theHobbit or silmarilion)
    GUI design and graphics: gama and mostly by maxo (aka rockMax) 

>> GOODBYE

If you have any suggestion or wanna help improve the app
please contact me at gama.coder@gmail.com.

This app was done spending several hours of my free time
and i did it because i really like music and programming
but if you feel a little generous and think the app deserves 
a prop you can make a donation at this link:
https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=gama%2ecoder%40gmail%2ecom&no_shipping=0&no_note=1&tax=0&currency_code=USD&lc=MX&bn=PP%2dDonationsBF&charset=UTF%2d8

Well have a lot of fun!  And enjoy the music!

