S2P (Slide2Play) v0.50 (15-8-2008) by A_C
=========================================
S2P is a stylus-free MP3/WMA player application. It simply lets you browse your music files & play.

Prerequisition:
===============
- WM5 Phone or WM6/6.1 Professional devices (with built-in Windows Media Player)
- free RAM: at least 3M

v0.50
=====
- the Album View now can flow. (since this view is very CPU intensive, it may be sluggish on your device)
- added 2 control buttons in the Album View.
- added option (FastAlbumPic) to retrieve embedded album pic faster (same as v0.38); but if the album pic cannot be loaded probably, disable this option.
- changed option AlwaysLoadAlbumPic to AlwaysLoadEmbedAlbumPic; it's only useful when a folder contains a mix of songs from different albums.
- the album pic & song info are now cached (under each folder as folder.jpg, s2p1.tag & s2p2.tag), i.e. the second time you visit the same album, it'll be faster.
- added support to HTC Diamond - both GSensor & AVRCP; for AVRCP, read the FAQs below for the detail trick.
- added support to RealVGA.
- won't keep the system alive when it's paused.
- separate CAB files for QVGA(low-res) & VGA(high-res) devices.
- fixed the issue that all memory was ate up for some problematic embedded album pic.
- some minor bugs fixed.

v0.41b (beta)
======
- special build for HTC Diamond; support GSensor (thanks Mr Scott Seligman) & AVRCP, read the FAQs below for the details.
- some minor bugs fixed.

v0.40
=====
- added AVRCP support (play/pause/next/previous) to devices that use MS BT stack.
- added DPAD control to "move" the playback when the timeline is shown.
- added "Repeat Single" - tap the repeat icon until a small "1" is shown.
- limited the way to change to portrait Album View by double tap the album title area only; to go back, double tap the album title area again.
- fixed the issue that some devices cannot run in Landscape mode.
- some minor bugs fixed.

v0.39
=====
- added option (NoSoftKey) to hide the bottom soft music control keys.
- added to show Album View at portrait mode by double tap the screen; to go back, double tap the screen again.
- now runs properly with RealVGA at 96dpi.
- rearranged some keys - END/OK to minimize; ACCEPT to quit.
- fixed some embedded album pic problems.
- some minor bugs fixed.

v0.38
=====
- reduced the RAM usage, especially when there are a lot of music files on the list.
- reduced the start up time.
- added option (FullScreenAlbum) to display a larger album art. For 240 x 240 device, please set it to 0.
- added a sliding button to "move" the playback.
- added minimize S2P by tapping the top right corner of the screen.
- rearranged some keys - END/OK to quit; ACCEPT to minimize.
- integration with S2U2 v1.00 or later (read the S2U2's readme.txt for details)
- all system icons are live when S2U2 (v1.00 or later) is already running in the background. (but it doesn't mean S2U2 is mandatory)
- runs properly on a 320x320 emulator, but not tested on any real 320x320 devices.
- some minor bugs fixed.

v0.32
=====
- fixed the issue that S2P did not start due to some problematic ROM/OEM.

v0.30
=====
- changed the music decorder from MAD to WMP, so no more OGG support, but now preliminarily supports WMA.
- added Album View screen. Under the music playback screen, slide up or down the left or right side edge of the album art will change to the Album View screen. To move to previous or next Album, tap the adjacent albums. To move faster, slide to left or right. To go back to the normal playback screen, slide up or down the left or right side edge of the album art.
- added option (ResumeAfterCall) to resume or stop the playback after a call is finished.
- added support to load Album art of WMP (Album*.jpg).
- added minimize S2P by pressing OK.
- added Landscape support: Under whichever Portrait or Landscape mode, the music playback screen will always in Portrait; and the Album View screen will always in Landscape.
- added more power saving for AVRCP: Normally, when an AVRCP command arrives, the LCD will be forced to turn on even it's offed. Under the same condition, S2P will turn the LCD off immediately.
- changed the layout a little so that the whole album art will be shown.
- smoother animation.
- a lot of minor bugs fixed.

Installation:
=============
- Under your PC/MAC/device, extract the content of the downloaded file & copy the CAB file to your device.
- Under your device, run any File Explorer application; go to the folder where the CAB file is copied; run the CAB file.
- If your device got a "Win32 error", please download & install the WMP-OCX-WM5-square-fix.cab (for square devices) or the WMP-OCX-fix.cab (for other devices).

Operations:
===========
- Since S2P simply scans music files in your storage card, it's suggested to have your music files well organized by folders. So that you can browse your music files through the folders instead of a plain list. (e.g. \Artist Name\Album Name\Music title.mp3)
- When browsing, press the folder name to list all music files under that folder, including subfolders; or press the arrow button to list the subfolders.
- Press any one of the filename to play.
- To go back to the music file list, press the top left back button.
- To view the current album list, press the top right icon. Then press any one on the list to play that music.
- To go back to the single music view, press the top right icon again.
- On the single music view, tap the screen to call up the timeline. Press the left repeat icon to repeat the current playing album; press the right shuffle icon to play the whole music list randomly. When both icons are on, only the current album will be played randomly.
- Under the music playback screen, slide up or down the left or right side edge of the album art will change to the Album View screen in Landscape mode. To go back to the normal playback screen, slide up or down the left or right side edge of the album art.
- Under the music playback screen, double tap the album title area will change to the Album View screen in Portrait mode. To go back to the normal playback screen, double tap the album title area again.
- The hardware keys are:
 Accept - quit
 End/OK - minimize
 Vol Up/Down or DPAD Up/Down - volume control
 DPAD Action - play/pause
 DPAD Left/Right - previous/next
 Left/Right soft key - previous/next album
 Power/Record - turn screen off

Settings:
=========
The behaviour of S2P can be altered by changing the following registry values stored at \HKEY_CURRENT_USER\Software\A_C\S2P\
- OffLCD - the no. of timeout seconds that S2P will turn off the screen when using battery; default is 25.
- ACOffLCD - the no. of timeout seconds that S2P will turn off the screen when using external power; default is 0 (i.e. disable).
- SaveLastMusic - remember the last playing music when quit; default is 1.
- AlwaysLoadEmbedAlbumPic - always load the embedded album pic when start to play a file; default is 0.
- ResumeAfterCall - resume the playback after a call is finished; default is 1.
- FullScreenAlbum - to display a full-screen album art; default is 1. (it's not usable for square screen device).
- NoSoftKey - to hide the bottom soft music control keys; default is 0.
- FastAlbumPic - retrieve the embedded album pic in faster speed but some problematic pic will not be retrieved properly; if that happen, disable it; default is 1.

Known limitations & FAQs:
=========================
Q. Do I have to install the old version before using this version?
A. No.

Q. How to use the .CAB file?
A. http://www.google.com/search?q=install+cab

Q. Do I have to install S2U2 before installing S2P?
A. No. But if you have installed S2U2, make sure you have updated your S2U2 to 0.99p or later. Otherwise S2P will be stopped by S2U2.

Q. What music files can S2P play?
A. MP3, WMA & WAV.

Q. When viewing an album of WMA/WAV files, there is no duration show?!
A. Yes, it's not implemented yet.

Q. The Album View only show a few covers even there a lot different music files stored?!
A. You have to organize the files into folder structure like \Artist Name\Album Name\Music title.mp3, otherwise it won't be recognized by S2P.

Q. How to turn off the screen when playing music?
A. Press the Power button or the record button.

Q. How to adjust the auto screen off timeout?
A. Edit the registry - under \HKEY_CURRENT_USER\Software\A_C\S2P\, edit the keys OffLCD & ACOffLCD (in seconds). OffLCD is for use when using battery; while ACOffLCD is for external power. The default value of OffLCD is 25 & ACOffLCD is 0.

Q. S2P shows weird characters for the music info?!
A. Try to resave those info in ID3V2.4 UTF-8 format.

Q. How to have cover shown on S2P?
A. Either the music file already has cover pic embedded or you have to copy the cover file (either cover.jpg or folder.jpg or album*.jpg made by WMP) to the corresponding album folder.
A. Sudermatt has a script to update the album art directly from your device, goto http://forum.xda-developers.com/showpost.php?p=2164454&postcount=920 for details.

Q. Does S2P support A2DP?
A. Yes, as long as your device has a proper OS.

Q. Does S2P support AVRCP?
A. Yes, starting from v0.40.

Q. How to get ACRCP work on HTC Diamond?
A. Follow these steps:
- remove the Music tap from TouchFlo 3D with Diamond TF3D Config (http://forum.xda-developers.com/showthread.php?t=405749 (thanks Sushilange);
- restart the device;
- turn on the Bluetooth & connect the BT Headset;
- start the Windows Media Player (sometimes it will be automatically started once the BT Headset is connected) & press the End key to minimize it;
- start S2P & enjoy

Q. Does S2P support playlist?
A. No, not yet.

Q. The system icons on the top bar do not update?!
A. Yes, they only show the start status. But the battery level icon is up-to-date. However, they will all be live if S2U2 v1.00 is already running in the background.

Q. Why S2U2, S2V & S2P are all free?
A. Because MS has left them in the factory.

Incompatible Devices
====================
- Asus 696
- Treo 800w

Others
======
Q. Is S2P free?
A. Yes, but any donations are welcome (https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=ac_dl%40hotmail%2ecom&item_name=S2P%20Donations&no_shipping=0&no_note=1&tax=0), thanks.

Special Thanks
==============
- Forum fellows at xda-developers (http://forum.xda-developers.com). Thank you for your testings, comments, supports & patience.

Enjoy!
A_C