Merge branch 'master' of https://git.maemo.org/projects/browser-switch
[browser-switch] / README
1 # browser-proxy.py
2 # version 2.2 by steven676 and xiojason
3 # (see http://browser-switch.garage.maemo.org/)
4
5 # simple python-dbus service that proxies osso_browser events to Tear
6 # based on code from http://paste.lisp.org/display/45824
7
8 # installation:
9 # 0. ensure the needed python packages are installed:
10 #    python2.5, python2.5-dbus, and python2.5-gtk2
11 # 1. place this file in /home/user as browser-proxy.py
12 # 2. make executable (chmod +x browser-proxy.py)
13 # 3. change /usr/share/dbus-1/services/com.nokia.osso_browser.service to read:
14 # [D-BUS Service]
15 # Name=com.nokia.osso_browser
16 # Exec=/home/user/browser-proxy.py
17 # 4. disable tablet-browser-service (aka browserd) (optional, saves memory)
18 # 5. you may wish to reboot.
19
20 # notes:
21 # - opening urls will be a bit slow. it takes some time to relay the messages to Tear
22 # - modifications to the script may require the killing of an already-running
23 #   browser-proxy.py process -- just use 'kill' to stop it.
24 # - modifying the osso_browser.service file prevents MicroB/browserd from working.
25 #   if you wish to restore MicroB/browserd, change the service file's contents back to:
26 # [D-BUS Service]
27 # Name=com.nokia.osso_browser
28 # Exec=/usr/bin/browser
29 #   and re-enable tablet-browser-service again.