PyS60RemoteControl

File Release Notes and Changelog

Release Name: 0.1

Notes:
====================
 PyS60RemoteControl
====================
http://pys60rc.sourceforge.net/
(c) 2007 Dorian Scholz
Released under the GNU General Public Licence

PyS60RemoteControl allows you to remote control your PC with a Symbian mobile 
phone with PyS60 via Bluetooth. 

It uses plugins written in Python to control and display information about applications.
Further more it supports other remote control systems (i.e. Girder). 

The following plugins are already avalaible, please contribute if you can: 

- Mouse: mouse move and button control, continous screen capturing with zooming and rotation

- WinAMP: playback control and status display

- MediaPlayerClassic: playback control

- WindowsMediaPlayer: playback control


====================
    Requirements
====================

- a mobile phone running Symbian OS S60 (tested on a Nokia N73 Music Edition running S60 3rd Edition)
- Windows XP/2000 with a working Bluetooth Serial Port (tested with Widcomm Stack on XP)


====================
      Install
====================

PC:
---

- install Python >= 2.3: http://python.org/ (tested with version 2.5)

- install the following Python packages (and their prerequisites obviously):
  - wxPython: http://www.wxpython.org/                  (tested with version 2.7.10)
  - pyserial: http://sourceforge.net/projects/pyserial/ (tested with version 2.2)
  - pywin32: http://sourceforge.net/projects/pywin32/   (tested with build 210)


Phone:
------

- install PyS60: http://sourceforge.net/projects/pys60/ (tested with version 1.3.17 3rd Edition)

- install PythonScriptShell: http://sourceforge.net/projects/pys60/ (tested with version 1.3.17 3rd Edition)

- copy all files from the 'PyS60RC\phone' directory to 'e:\Python' on your phone.


====================
   Configuration
====================

PC:
---

- open PyS60RemoteControl.conf with a simple text editor (the file contains the repr of a Python dictonary)
- edit the line 'com_port' to reflect your setup
- you can edit the line 'skin' if you find a skin for your phone model in the skins directory
- you can also edit the lines 'verbose' and 'bluetooth_verbose' to see more or less annoying messages (a value of 1 or 2 is recommended)


====================
        Use
====================

PC:
---

- run the 'PyS60RemoteControl.py' script 
(preferably from a console, so you can actually read the error message in case it's not working right away ;-)


Phone:
------

- if the PC part is up and running, you can start the 'PyS60RC-phone.py' script from the PythonScriptShell
- on startup it will let you select the Bluetooth device to connect to (and you have to do the whole pairing thing...)
- if you always connect to the same device, you can change the 'PyS60RC-phone.py' script first line to
  ALWAYS_ASK_FOR_BLUETOOTH_DEVICE = False
- if everything is working you should see the logo screen and the left softkey should open a menu with some options

- now you should select 'Tools->Learn Keymap' from the menu and press every key you are asked to

- you are now ready to really use the PyS60RemoteControl


====================
 More Configuration
====================

The key configuration can be done from the phone for each plugin:
- select 'Tools->Assign Plugin Keys' menu after when the plugin is running and press a key for every command

Look in the 'plugin' directory for the '.conf' files. They contain simple Python dictonaries with configuration options for each plugin.


====================
    Known Issues
====================

- the phone app can only be exited via the red disconnect button, if it is not connected to the PC
  (this is because it waits forever trying to read from the bluetooth connection)


====================
        Todo
====================

- Mouse: reduce the pain of the lag of screen updates, especially during mouse moves:
  - move mouse cursor on phone screen to indicate how far we have moved
    (updates need to be more frequently than the screen updates from the PC)

- Documentation: document the plugin system...

====================
      Licence
====================

PyS60RemoteControl for Symbian OS(TM)
Copyright 2007 Dorian Scholz
Released under the GNU General Public Licence (see file GPL.txt)


Changes:
====================
 PyS60RemoteControl
====================
http://pys60rc.sourceforge.net/
(c) 2007 Dorian Scholz


26.01.2007 
- first public release, let's call it version 0.1