+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+
+<html>
+
+<head>
+<title>Browser Switchboard - default browser selection for Maemo</title>
+</head>
+
+<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,
+and can also be used to launch MicroB without having browserd running.</p>
+
+<h2>Current Release</h2>
+<p>Version 3.0 (2009/12/23) (<a href="browser-switchboard.install">Diablo one-click install</a>, <a href="https://garage.maemo.org/frs/download.php/7112/browser-switchboard_3.0-1fremantle1_armel.deb">EXPERIMENTAL Fremantle package</a>)</p>
+<ul>
+<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>
+
+<h2>Getting Browser Switchboard</h2>
+<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>, EXPERIMENTAL 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>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. 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 Web menu entry in the applications menu (for Maemo 4.x,
+located in the Internet menu by default), or by running "browser" 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>Some users have reported that a restart may be necessary to ensure that
+Browser Switchboard is functioning. If you experience trouble after
+installing the package, try rebooting your device first.</p>
+
+<h2>Documentation</h2>
+<p>See the
+<a href="https://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=38273">Browser Switchboard thread</a>
+on the talk.maemo.org forums.</p>
+
+<h2>Development</h2>
+<p>The latest source is available via a Git repository; you can check it out
+by running</p>
+<pre>
+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>
+
+<p>Bug reports and patches can be emailed to the maintainers, or posted on the
+forum thread.</p>
+
+<h2>Maintainers</h2>
+<p>Steven Luo
+<<a href="mailto:steven+maemo [at] steven676.net">steven+maemo [at] steven676.net</a>>
+is the primary maintainer of Browser Switchboard, with assistance from Jason
+Simpson (the original developer).</p>
+</body>
+
+</html>
projects / browser-switch / commitdiff
