README.md
2PlayMe 4.1
-----------

2PlayMe gives you the possibility to wake up every morning with your favorite
mp3-song. 2PlayMe enhances the free RealPlayer program to play the songs. Beside
this function, 2PlayMe also displays a fancy 3-dimensional watch on your PDA.
Update: 2PlayMe works also with the registered versions of Pocket Tunes and AeroPlayer.
Update: 2PlayMe can show any JPEG file on your expansion card as background.
Update: 2PlayMe can show a nice fire effect as background.
Update: 2PlayMe works also with the internal AudioPlayer of TH55
Update: 2PlayMe uses pnoJpegLib on ARM-devices (speed up of Jpeg loading)
Update: 2PlayMe has a snooze feature in coolaboration with PocketTunes or AeroPlayer
and an explicit selected song or the internal midi alarm
Update: Together with the snooze feature a safe alarm is available: 2PlayMe calls the system
alarm, if you haven't dismissed the alarm within 10 minutes

Installation:
-------------

Please install 2playme_en.prc on your device. If you have a PalmOS 5.x device
(which runs on an ARM processor) install pnoJpegLib.prc. If you have a PalmOS 4.x
device install JpegLib.prc.


Requirements:
-------------

PDA with
* Palm OS 4.1 or better
* either
RealPlayer (www.real.com)
or
Pocket Tunes (registered)
or
AeroPlayer (registered)
or
Sony's internal audio player (tested with TH55)
or
Internal Alarm (use your own MIDI file)
* maybe Expansioncard (for MP3-Songs and background image)
* audio output


Usage:
------

Run 2PlayMe and tip the screen to display the settings dialog.
* Test the connection with RealPlayer by pressing "Test". RealPlayer will open after
some seconds and shortly after it will start playing.
* Adjust the alarm time, enable the alarm and press "Done".
* If you have a device with enabled Key-lock feature, you can only use Pocket Tunes, AeroPlayer or internal alarm.
* The Sony part does work with TH55, Audioplayer 3.2. Other devices and version may or may not work.


Specials:
---------

* 2PlayMe allows you to have a desktop-triggered Hotsync.
How does it work?
* Create a file on the desktop with the extension .hot
* Send this file using bluetooth to your handheld
* 2PlayMe will receive this file and trigger a Cradle-Hotsync 5 seconds later

* 2PlayMe can show the date, time and memory on handheld startup
How does it work?
* Go to "More" and enable "Show Time on Start"

* 2PlayMe can switch on your Phone (Treo 650/600) after a reset
How does it work?
* Create a Phone-On alarm and enable "Also on Reset"

* 2PlayMe can start an app and simulate button press
How does it work?
* Define a Internal Application alarm, select "enqueue ButtonPress". Use the freeware
Bird (http://www.ppcompiler.org/?lng=en) to find the ID of the control.
* You might alternative use PRCExplorer (http://www.palmgear.com/index.cfm?fuseaction=software.showsoftware&prodid=40542)
to find the correct control ID.


Henk Jonas
metaview@web.de




History:
--------

1.0 (01/30/2004)
* first release

1.0.1 (01/30/2004)
* fixed unlock code

1.1.0 (01/31/2004)
* fixed unpredictable alarm behaviour after "Test"
* fixed one use of global in PilotMain
* made "12" better recognizable

1.2.0 (02/11/2004)
* works with Pocket Tunes and AeroPlayer too
* select the weekdays for which to set the alarm
* added possibility to add your own MIDI-file as internal alarm
* added possibility to add your own background picture

1.3.0 (02/21/2004)
* select one of the installed midi songs as internal alarm
* select a JPEG file as background picture (needs JpegLib.prc)
* configure the color of the clock
* can also alarm only once

1.4.0 (06/26/2004)
* Displays a "Please wait" message during JPEG loading
* enables 16-bit mode, if possible
* reregisters alarm after reset and after program update
* displays day/time of next alarm
* displays day/date of today
* no more unneccessary wake-ups of your Palm
* uses Pocket Tunes API to bypass keylocks (only for Pocket Tunes)

1.4.1 (07/09/2004)
* Fixed bug with settings and use of "Only once"
* Added old way to call Pocket Tunes ("Current")
* Intern and Pocket Tunes API also alarm if another alarm is still pending

1.4.2 (07/16/2004)
* working Sony support (Tested with TH55, Audioplayer 3.2)
* german version

1.4.3 (07/25/2004)
* "Current" for Pocket Tunes was broken...

1.5 (11/24/2004)
* supports Hires+
* better handling of large JPEG's
* select background color

1.5a (12/24/2004)
* fixed Graffiti-handling on Sony
* fixed bug regarding sound and image list
* better error message, if background file wasn't found
* no midi anymore before Sony's audio player
* Text better readable

1.5b ()
* handles now more than one expansion card (Zodiac, T5 etc.)
* shows in which directories it looks for files
* uses pnoJpegLib on ARM-devices (speed up of Jpeg loading)

1.6 (01/27/2005)
* recursive directory handling for background image and pocket tunes file

1.7 (02/21/2005)
* Snooze feature for Pocket Tunes (with selected song) and internal Midi Alarm
* Safe Alarm for Pocket Tunes (with selected song) and internal Midi Alarm

1.8 (03/08/2005)
* Safe alarm wasn't working in all conditions, fixed
* new background option added: animated fire effect
* prevents switching to launcher when an expansion card is inserted

2.0 (07/24/2005)
* multiple Alarms (up to 99)
* Fixed possible bug, if background picture wasn't a jpeg.
* Only jpeg files are listed in background picture box.
* Background picture list and song list for Pocket Tunes and AeroPlayer are sorted.
* "Current" is back for Pocket Tunes (thanx to Thomas Heinrich)
* "Random" is added to PTunes and APlayer
* AeroPlayer can be called with selected song
* adjustable snooze time
* adjustable alarm volume

2.1 (11/03/05)
* reworked rotation settings
* better approach to bypass keylock on Treo
* faster access to alarm settings
* automatically Softreset added
* "FadeIn" and "Continuesly play"

2.2 (03/11/06)
* safe alarm uses vibration if possible
* safe alarm repeats 5 times
* fail-back alarm uses vibration if possible
* can switch on/off WLAN on TX
* can switch on/off Phone on Treo 650 (600 not tested)
* better (and less memory consuming) way to do the random mp3-playing

3.0 (03/30/06)
* redesigned GUI
* different colors for different alarm types in alarm list
* filter for the alarm list
* allows to show time/memory information on power on
* allows to switch on the phone automatically after a reset (tested on Treo 650)
* enables desktop triggered hotsync

3.1 (05/23/06)
* different timing for PIN entering in Phone On
* don't try to enqueue the PIN if the phone was already powered on
* added WakeOnLan-paket sending
* added Battery check, to give a signal if the battery goes below a certain level
* better and more compatible way to switch off the device
* fixed bug regarding mixed entries for BT On/Off and Softreset

3.2a (07/23/06)
* 2PlayMe also works when moved to ROM
* BT On/Off on Treo without BTToggle possible
* Sound On/Off possible
* Labels for internal (MIDI) Alarm
* playlists possible with AeroPlayer and PTunes
* safer handling of background file playing with PTunes
* 2 snooze buttons, selected snooze time or 1/2 of the snooze time
* some small GUI updates
* the alarm stuff is also available as light version

3.3 (08/25/06)
* Snooze is triggered when pressing power or one of the other application buttons
* allows to change the default network connection (switch to WiFi and back to BT or GPRS on a daily schedule)
* allows to set the AutoOffTimer
* RFC868 Time sync possible (hard coded time server at the moment: time-a.nist.gov, 129.6.15.28)
* connection to MacroPlay (http://xvisionnow.tripod.com/cgi-bin/index.pl)
* connection to my updated Timidity app to play any real MIDI file from the memory card (might not work on all devices)
* small GUI update: better categorized
* small GUI update: toggle enable/disable with a tap in the title row of the table
* On Treo only: when device is muted, we vibrate before we play any music
* On Treo only: keyboard light on/off

3.3a (09/07/06)
* possible crash fixed when editing an alarm
* feature added: skip clock
* feature added: make fullscreen (on DIA devices)

3.4 (10/25/06)
* "Switch-On" alarm disables the keyguard.
* Volume setting in MP3-Alarm is now a slider. (well done, Ruben Gutknecht :-)
* Old volume settings in Pocket Tunes and AeroPlayer are restored. (this one too)
* IR Receive On/Off added.
* Close down all open network connections added.
* Plain background pic option added.
* Can start an internal app also on Reset + Enqueue Center button, Control select or Menu item.
* Can start an internal app also on Power Off + Enqueue Center button, Control select or Menu item.
* Can also enqueue Control select or MenuItem select when called an internal app.

3.4a (10/29/06)
* better timing when enqueue ControlButtons etc.
* some GUI fixes
* screen flashs when doing a "Test Alarm"
* bug fixed in "Network Down" (thx to Jim Schulz for all these testings)
* bug fixed in "Default Connection"

3.5 (02/22/07)
* bug fixed in "Battery Check"
* list wasn't always sorted, fixed
* bug fixed when switching the main alarm selection
* Version check in PTunes-alarm, prevents crash on older PTunes versions
* added "Launch on Hotsync"
* bug fix in .m3u handling
* can enqueue a "ShortCut5"-shortcut, use a number 0...9999 as shortcut name
* shows Time and Date during MP3 alarm
* bug fixed in handling of background image size
* add support for http: in m3u
* digital clock view
* leaving the settings dialog will always save the alarm list
* a different way to mute/unmute on Treo
* added option "quiet'n'dark" to Phone On/Off
* you can define alarms for the same time as long as the days don't overlap
* added support for mOcean (starting with v3.0.14)
* added support for TCPMP
* I've removed RealPlayer, Sony's AudioPlayer and "Current" in PTunes and AeroPlayer:
You can use Other App and enqueue either a center key press or a menu item, like 1101 for PTunes-Action: Play

3.6 (03/09/07)
* different paths for different players
* "clone" for repeating alarm entries
* "delete all" added
* binary clock added
* mute/unmute fixed?
* adjustable time-out for PIN entering in phone on
* phone off on 700p works again
* Import/Export for Alarmlists
* FadeOut can be skipped

3.7 (03/05/08)
* "security on/off" added
* "easy time" added, will be shown in the lower right corner for easier time reading :-)
* can control keyguard on Treo
* 120s for fade in added
* light fades in too when using a fade-in mp3 alarm
* light blinks on safe-alarm
* recognizes Treo Centro
* 12 hour AM/PM display added

3.8 (03/11/08)
* fixed AM/PM display
* "Next alarm" display also with "No clock"-display

3.9 (03/21/08)
* CountDown display
* Centro compatibility
* "Easy time" in locale format

4.0 (10/12/08)
* Added week selection: Select the weeks on which this alarm is enabled (every week is default).
* Added list of next 12 alarms.
* Treo/Centro keyguard control: Enable also for 5 sec and 30 sec
* Treo/Centro keyguard control: bug fixed for Enable
* Treo/Centro Phone On: IMSI can be stored and 2PlayMe will then try twice to power the phone on with this SIM card.
* Treo/Centro: can schedule SMS sending
* Can bypass Butler's keyguard.
* When selecting "Once", the next matching day for the given alarm time is selected too.
* Small enhancements

4.1 (05/25/09)
* fixed "only once"-alarm
* added NTP-Timesync (example IP: 213.239.202.209)