Update Changelog
[browser-switch] / www / index.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
2         "http://www.w3.org/TR/html4/strict.dtd">
3
4 <html>
5
6 <head>
7 <title>Browser Switchboard - default browser selection for Maemo</title>
8 </head>
9
10 <body>
11 <h1>Browser Switchboard</h1>
12
13 <p>
14 <img src="cp-screenshot-diablo.jpg" width="350" alt="Browser Switchboard control panel screenshot on Diablo">
15 <img src="cp-screenshot-fremantle.jpg" width="350" alt="Browser Switchboard control panel screenshot on Fremantle">
16 </p>
17
18 <p>Browser Switchboard (formerly browser-proxy) is a program which allows
19 you to choose which browser to use as the default browser on Maemo devices.
20 It supports MicroB, Tear, Fennec/Mobile Firefox, and Midori out of the box,
21 and can also be used to launch MicroB without having browserd running.</p>
22
23 <h2>Current Release</h2>
24 <p>Version 3.1 (2010/01/15) (<a href="browser-switchboard.install">Diablo one-click install</a>, <a href="https://garage.maemo.org/frs/download.php/7447/browser-switchboard_3.1-2fremantle2_armel.deb">Alpha-quality Fremantle package</a>)</p>
25 <ul>
26 <li>Fremantle: add a new, more finger-friendly GUI, based on work by Faheem Pervez</li>
27 <li>make sure reconfig signal (SIGHUP) doesn't interrupt dispatch of a request when continuous mode is off</li>
28 <li>disable autocapitalization and predictive text features for the other_browser_cmd entry in the UI</li>
29 </ul>
30
31 <h2>Getting Browser Switchboard</h2>
32 <p><b>For Diablo/Maemo 4.1</b>, the recommended way to install Browser
33 Switchboard is via the Maemo
34 <a href="http://wiki.maemo.org/Extras">Extras repository</a>,
35 which is enabled by default in the Application Manager.
36 You should find Browser Switchboard in the Application Manager catalog under
37 the network category.  Alternately, if you're viewing this page on your Diablo
38 device, opening the <a href="browser-switchboard.install">one-click install</a>
39 will install the package from Maemo Extras for you.</p>
40 <p>Source code and packages can also be found on the Maemo Garage
41 <a href="https://garage.maemo.org/frs/?group_id=1159">download page</a>.</p>
42
43 <p><b>For Fremantle/Maemo 5</b>, alpha-quality packages and source code
44 can be found on the Maemo Garage
45 <a href="https://garage.maemo.org/frs/?group_id=1159">download page</a>.
46 Packages can also be installed from the Maemo
47 <a href="http://wiki.maemo.org/Extras-devel">extras-devel repository</a>
48 (though don't blindly enable extras-devel and install/upgrade &mdash; see
49 the linked page first!)</p>
50
51 <h2>Quick Start</h2>
52 <p><b>For Diablo/Maemo 4.1</b>, just open the
53 <a href="browser-switchboard.install">one-click install</a> in a browser on
54 your device and follow the instructions to install Browser Switchboard.</p>
55 <p><b>For Fremantle/Maemo 5</b>, or if you want to install the package by hand:</p>
56 <ol>
57 <li>Download the binary package: browser-switchboard_X.Y-Z_all.deb
58 (where X.Y-Z is the version number, of course).</li>
59 <li>Install the package using the Application Manager.</li>
60 </ol>
61
62 <p><img src="cpapplet-diablo.jpg" width=320 alt="Browser Switchboard control panel UI"><br>
63 You can now select the default browser by using the Browser Switchboard
64 applet in the Control Panel.  Links in most applications, locally-saved
65 web pages opened from the file manager, and (for Maemo 4.x) entries in
66 the Web sidebar panel will open in the browser that you select as the
67 default.  If you don't configure a default browser, MicroB will continue
68 to be used as the default browser.</p>
69
70 <p>No matter which browser you select as the default, MicroB can always be
71 opened via the Web menu entry in the applications menu (for Maemo 4.x,
72 located in the Internet menu by default), or by running "browser" from
73 the shell.  While MicroB is open, it will receive all links from other
74 applications; closing MicroB will restore your chosen default browser.</p>
75
76 <p>For Fremantle/Maemo 5, a restart is necessary to ensure that
77 Browser Switchboard is functioning.  In any event, if you experience trouble
78 after installing the package, try rebooting your device first.</p>
79
80 <h2>Documentation</h2>
81 <p>See the
82 <a href="http://git.maemo.org/projects/browser-switch/?p=browser-switch;a=blob_plain;f=README;hb=HEAD">README</a>
83 for further instructions on how to configure and use Browser Switchboard.</p>
84
85 <h2>Support</h2>
86 <p>You can email your question to the maintainers (see below), or you can take
87 it to the
88 <a href="http://talk.maemo.org/showthread.php?t=38273">Browser Switchboard thread</a>
89 on the talk.maemo.org forums.</p>
90
91 <h2>Development</h2>
92 <p>The latest source is available via a Git repository; you can check it out
93 by running</p>
94 <pre>
95 git clone https://git.maemo.org/projects/browser-switch
96 </pre>
97 <p>from a shell. You can also
98 <a href="http://git.maemo.org/projects/browser-switch/?p=browser-switch;a=summary">browse the repository</a> using gitweb.</p>
99
100 <p>Bug reports and patches can be emailed to the maintainers, or posted on the
101 forum thread.</p>
102
103 <h2>Maintainers</h2>
104 <p>Steven Luo
105 &lt;<a href="mailto:steven+maemo [at] steven676.net">steven+maemo [at] steven676.net</a>&gt;
106 is the primary maintainer of Browser Switchboard, with assistance from Jason
107 Simpson (the original developer).</p>
108 </body>
109
110 </html>