<body>
<h1>Browser Switchboard</h1>
+
+<p>
+<img src="cp-screenshot-diablo.jpg" width="350" alt="Browser Switchboard control panel screenshot on Diablo">
+<img src="cp-screenshot-fremantle.jpg" width="350" alt="Browser Switchboard control panel screenshot on Fremantle">
+</p>
+
<p>Browser Switchboard (formerly browser-proxy) is a program which allows
you to choose which browser to use as the default browser on Maemo devices.
-It supports MicroB, Tear, Fennec/Mobile Firefox, and Midori out of the box,
+It supports MicroB, Tear, Mobile Firefox, Opera Mobile, and Midori out of the box,
and can also be used to launch MicroB without having browserd running.</p>
<h2>Current Release</h2>
-<p>Version 3.0rc1 (2009/12/18) (<a href="https://garage.maemo.org/frs/download.php/7081/browser-switchboard_3.0rc1-1_armel.deb">Diablo package</a>)</p>
+<p>Version 3.2-2 (2010/05/28) (<a href="browser-switchboard.install">Diablo one-click install</a>, <a href="https://garage.maemo.org/frs/download.php/8174/browser-switchboard_3.2-2fremantle1_armel.deb">Beta-quality Fremantle package</a>)</p>
<ul>
-<li>Release candidate -- not (yet) a stable release</li>
-<li>Add a control panel applet to help configure the UI</li>
-<li>Reimplement the core D-Bus proxy in C to improve speed and memory footprint</li>
-<li>Default to launching MicroB as the default browser if unconfigured -- if you were using Browser Switchboard to launch Tear, you need to explicitly set Tear as the default browser using the UI (or by configuring by hand)</li>
-<li><b>EXPERIMENTAL</b> Fremantle support (see <a href="https://garage.maemo.org/frs/?group_id=1159">download page</a> for source and packages). BACK UP before installing, and let me know how it goes!</li>
-</ul>
-<p>Version 2.2 (2009/12/14) (<a href="https://garage.maemo.org/frs/download.php/7038/browser-switchboard_2.2-1_all.deb">Diablo package</a>)</p>
-<ul>
-<li>Rename the package to browser-switchboard</li>
-<li>Move the config file to /home/user/.config/browser-switchboard, and
-fall back to the old location if no config file is found</li>
-<li>If no config file is found and Tear isn't installed, launch MicroB;
-this avoids breaking link opening on a system with a freshly installed
-browser-switchboard package and Tear not installed</li>
-<li>Package no longer depends on Tear; should make it easier for users of
-other alternative browsers to use Browser Switchboard</li>
-<li>substantial documentation update</li>
+<li>Make the "Web" menu entry and /usr/bin/browser script open the selected default browser, and provide a new "MicroB" menu entry and /usr/bin/microb script for launching MicroB.</li>
+<li>[Fremantle] Launching and closing MicroB now works! Many thanks to everyone who tested this and provided feedback, especially Faheem Pervez and Uwe Kaminski.</li>
+<li>Add support for Opera Mobile.</li>
+<li>[Fremantle] Restarting the device after a fresh install of Browser Switchboard should no longer be necessary. Make sure you close any open MicroB browser windows before installing/upgrading, though! (Restarting after installation has never been required on Diablo.)</li>
+<li>[Fremantle] Force the Ovi Store bookmark to open in MicroB, since Ovi Store doesn't load in other browsers. Thanks to ToJa92 of the talk.maemo.org forums for reporting this.</li>
+<li>Add the ability to send debug logging output to syslog as well as the terminal, and add a config setting "logging={stdout,syslog,none}" to configure it. Thanks to Faheem Pervez for the suggestion.</li>
+<li>Turn on additional optimizations for code size, which should reduce disk and memory footprint slightly, and also possibly improve startup time.</li>
+<li>Miscellaneous minor bugfixes and cleanups.</li>
</ul>
<h2>Getting Browser Switchboard</h2>
-<p>Source code and packages for Diablo can be found on the maemo Garage
+<p><b>For Diablo/Maemo 4.1</b>, the recommended way to install Browser
+Switchboard is via the Maemo
+<a href="http://wiki.maemo.org/Extras">Extras repository</a>,
+which is enabled by default in the Application Manager.
+You should find Browser Switchboard in the Application Manager catalog under
+the network category. Alternately, if you're viewing this page on your Diablo
+device, opening the <a href="browser-switchboard.install">one-click install</a>
+will install the package from Maemo Extras for you.</p>
+<p>Source code and packages can also be found on the Maemo Garage
<a href="https://garage.maemo.org/frs/?group_id=1159">download page</a>.</p>
+<p><b>For Fremantle/Maemo 5</b>, beta-quality packages and source code
+can be found on the Maemo Garage
+<a href="https://garage.maemo.org/frs/?group_id=1159">download page</a>.
+Packages can also be installed from the Maemo
+<a href="http://wiki.maemo.org/Extras-devel">extras-devel repository</a>
+(though don't blindly enable extras-devel and install/upgrade — see
+the linked page first!)</p>
+
+<h2>Quick Start</h2>
+<p><b>For Diablo/Maemo 4.1</b>, just open the
+<a href="browser-switchboard.install">one-click install</a> in a browser on
+your device and follow the instructions to install Browser Switchboard.</p>
+<p><b>For Fremantle/Maemo 5</b>, or if you want to install the package by hand:</p>
+<ol>
+<li>Download the binary package: browser-switchboard_X.Y-Z_all.deb
+(where X.Y-Z is the version number, of course).</li>
+<li>(Maemo 5 only) Make sure that all your MicroB windows are closed —
+the installation/upgrade process will cause MicroB to exit.</li>
+<li>Install the package using the Application Manager.</li>
+</ol>
+
+<p><img src="cpapplet-diablo.jpg" width=320 alt="Browser Switchboard control panel UI"><br>
+You can now select the default browser by using the Browser Switchboard
+applet in the Control Panel. Links in most applications, locally-saved
+web pages opened from the file manager, and (for Maemo 4.x) entries in
+the Web sidebar panel will open in the browser that you select as the
+default. Opening the "Web" menu entry and running "browser" from the
+shell will also cause your chosen default browser to open. If you don't
+configure a default browser, MicroB will continue to be used as the
+default browser.</p>
+
+<p>No matter which browser you select as the default, MicroB can always be
+opened via the MicroB menu entry in the applications menu (for Maemo
+4.x, installed in the Extras menu by default), or by running "microb"
+from the shell. While MicroB is open, it will receive all links from
+other applications; closing MicroB will restore your chosen default
+browser.</p>
+
+<p>If you experience trouble after installing the package, try rebooting
+your device. If that fixes things, please report this as a bug.</p>
+
<h2>Documentation</h2>
<p>See the
-<a href="https://git.maemo.org/projects/browser-switch/?p=browser-switch;a=blob_plain;f=README;h=e7917c6664913fef15cce3b2bc7f974a5e664a4c;hb=HEAD">README</a>
-for instructions on how to configure and use Browser Switchboard.</p>
+<a href="http://git.maemo.org/projects/browser-switch/?p=browser-switch;a=blob_plain;f=README;hb=HEAD">README</a>
+for further instructions on how to configure and use Browser Switchboard.</p>
<h2>Support</h2>
<p>You can email your question to the maintainers (see below), or you can take
it to the
-<a href="http://talk.maemo.org/showthread.php?t=28539">Tear thread</a>
+<a href="http://talk.maemo.org/showthread.php?t=38273">Browser Switchboard thread</a>
on the talk.maemo.org forums.</p>
<h2>Development</h2>
git clone https://git.maemo.org/projects/browser-switch
</pre>
<p>from a shell. You can also
-<a href="https://git.maemo.org/projects/browser-switch/?p=browser-switch;a=summary">browse the repository</a> using gitweb.</p>
+<a href="http://git.maemo.org/projects/browser-switch/?p=browser-switch;a=summary">browse the repository</a> using gitweb.</p>
<p>Bug reports and patches can be emailed to the maintainers, or posted on the
forum thread.</p>
projects / browser-switch / blobdiff