
OLDPLAY for Dingux v1.12 by gama
Based on Oldplay v1.33 for GP2x by sasq & micket
-------------------------------------------------

This is a port of a great music app for the gp2x, wich
i never had the chance to try because i never got a gp2x, 
so i decided to test it on the dingoo.  

For those who doesn't know the app, it is an open source
multi format music player wich currently supports a lot 
of game and other music formats.  


Changelog

v 1.12
- Fixed transparent zip support using blargg's great 
  File_Extractor Library, which also supports other
  compressed formats like gzip, rar, 7zip, among others.
  * NOTE: Many rar and 7z files needs a lot of ram to be
    uncompressed, so i recommend using zip instead *
- Added tta plugin.
- Added wavpack plugin.
- Added support for .mp4 and .m4a extensions in the faadplugin.
- Reduced executable size.
- Fixed mp3 bus error/seg fault issue when trying to load
  a second song.
- Replaced mad plugin with a new one based on mpg123.

v 1.11
- Added aac plugin based on FAAD2.
- Added SC68 plugin.
  * Please copy the Replay folder and the config.txt file */
- Fixed error when searching for TFMX sample files in uade plugin.
- Fixed subtune support in uade plugin.
- Fixed audio issue when song ended in uade plugin.
- Switched to stereo sound in uade plugin.

v 1.10
- Added UADE plugin :).
  * To play an amiga song using the UADE plugin
    you need to copy the players folder and the score, 
    uaerc, eagleplayer.conf and uade.conf files to 
    the oldplay folder.  Also you don't need to change
    the names of the songs since the plugin should handle
    prefix extensions too. *
- Added new ST-Sound plugin.
- Added new Hively Tracker plugin.
- Added song description tags in vgmstream plugin.
- Added a formats database (formats.db) for vgmstream and UADE plugins.
  * Basically is a file that includes a list of all supported
    extensions by these plugins.  They support a LOT of 
    formats (~350 by UADE and ~250 by vgmstream) and i 
    haven't tested all of them, so some may not work. *


Features

Currently i have ported the following plugins:

 - FLAC
 - Modplug
 - AdPlug
 - Sidplay (based on sidplay1)
 - game_music_emu
 - vorbis
 - Timidity
 - UADE
 - FAAD
 - TTA
 - WavPack

* NEW *
 - mpg123
 - ST-Sound
 - Hively Tracker
 - SC68

And i have replaced the old pokecubed plugin with a 
new one based on vgmstream.

Almost every internal feature is supported:

- Playlist
- Zip support
- Themes
- CPU scaling
- Keymapping
- etc


TODO
-----

- Port remaining plugins.
- Reduce executable size ...
- Fix battery level indicator (?).
- Help me think of something :).


This is the default key configuration:

KEYS
----

DINGOO  Action
......  .......................... 
Start   Pause
Pad     Navigate, Rewind, Fast Forward & Subsongs
Sel     Switch playlist/browser
B       Play, Enter dir or zipfile
Y       Add song to playlist
 (in playlist)   Move song to after current

L+A     Save Playlist
L+Sel   Hold (lock keys)
L+Up    Volume Up
L+Down  Volume Down
L+Right Default song length up
L+Left  Default song length down

R+Right Select next subtune (in browser)
R+Left  Select prev subtune (in browser)

X       Parent
R+X     Remove song (in playlist)
A       Skip to Next Song
R+A     Skip to previous song
R+Y     Repeat On/Off
R+B     Shuffle On/Off
R+Up    Page Up
R+Down  Page Down
R+Start Quit

R+L+A            Take Screenshot
R+L+Start        Screen & backlighting on/off
R+L+Select       Activate/cycle CPU Scaling.
                 (Decreases cpu freq by 12 Mhz)
R+L+Y            Toggle sound blend on or off.
R+L+Up           Increase blend factor.
R+L+Down         Decrease blend factor.

* The power switch can also be used as a button.


INSTALL
--------

* IMPORTANT *
Don't forget to copy the file formats.db to the oldplay folder.

To install if you are using dmenu, you can create an entry 
in the menu_media.cfg like this one:

MenuItem Oldplay
{
Icon = "res/media/oldplay.png"
Name = " Oldplay"
Executable = "./oldplay"
WorkDir = "/usr/local/apps/oldplay"
}

And copy the oldplay folder with all it's contents to
/usr/local/apps.  You must supply an icon or use the 
included oldplay.png icon.

To install in gmenu2x, just press select and search for
the executable or let gmenu2x do it for you with the automatic
search :).


Well i hope you enjoy this one as much as i do :)

  Thanks a lot to sasq and micket, the creators
  of this wonderfull homebrew and of course to every
  developer who has made posible for us enjoy digital music.
