git.maemo.org Git - browser-switch/blob - 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, Mobile Firefox, Opera Mobile, 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.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>
  25 <ul>
  26 <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>
  27 <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>
  28 <li>Add support for Opera Mobile.</li>
  29 <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>
  30 <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>
  31 <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>
  32 <li>Turn on additional optimizations for code size, which should reduce disk and memory footprint slightly, and also possibly improve startup time.</li>
  33 <li>Miscellaneous minor bugfixes and cleanups.</li>
  34 </ul>
  35
  36 <h2>Getting Browser Switchboard</h2>
  37 <p><b>For Diablo/Maemo 4.1</b>, the recommended way to install Browser
  38 Switchboard is via the Maemo
  39 <a href="http://wiki.maemo.org/Extras">Extras repository</a>,
  40 which is enabled by default in the Application Manager.
  41 You should find Browser Switchboard in the Application Manager catalog under
  42 the network category.  Alternately, if you're viewing this page on your Diablo
  43 device, opening the <a href="browser-switchboard.install">one-click install</a>
  44 will install the package from Maemo Extras for you.</p>
  45 <p>Source code and packages can also be found on the Maemo Garage
  46 <a href="https://garage.maemo.org/frs/?group_id=1159">download page</a>.</p>
  47
  48 <p><b>For Fremantle/Maemo 5</b>, beta-quality packages and source code
  49 can be found on the Maemo Garage
  50 <a href="https://garage.maemo.org/frs/?group_id=1159">download page</a>.
  51 Packages can also be installed from the Maemo
  52 <a href="http://wiki.maemo.org/Extras-testing">extras-testing repository</a>
  53 (though don't blindly enable extras-testing and install/upgrade &mdash; see
  54 the linked page first!)</p>
  55
  56 <h2>Quick Start</h2>
  57 <p><b>For Diablo/Maemo 4.1</b>, just open the
  58 <a href="browser-switchboard.install">one-click install</a> in a browser on
  59 your device and follow the instructions to install Browser Switchboard.</p>
  60 <p><b>For Fremantle/Maemo 5</b>, or if you want to install the package by hand:</p>
  61 <ol>
  62 <li>Download the binary package: browser-switchboard_X.Y-Z_all.deb
  63 (where X.Y-Z is the version number, of course).</li>
  64 <li>(Maemo 5 only) Make sure that all your MicroB windows are closed &mdash;
  65 the installation/upgrade process will cause MicroB to exit.</li>
  66 <li>Install the package using the Application Manager.</li>
  67 </ol>
  68
  69 <p><img src="cpapplet-diablo.jpg" width=320 alt="Browser Switchboard control panel UI"><br>
  70 You can now select the default browser by using the Browser Switchboard
  71 applet in the Control Panel.  Links in most applications, locally-saved
  72 web pages opened from the file manager, and (for Maemo 4.x) entries in
  73 the Web sidebar panel will open in the browser that you select as the
  74 default.  Opening the "Web" menu entry and running "browser" from the
  75 shell will also cause your chosen default browser to open.  If you don't
  76 configure a default browser, MicroB will continue to be used as the
  77 default browser.</p>
  78
  79 <p>No matter which browser you select as the default, MicroB can always be
  80 opened via the MicroB menu entry in the applications menu (for Maemo
  81 4.x, installed in the Extras menu by default), or by running "microb"
  82 from the shell.  While MicroB is open, it will receive all links from
  83 other applications; closing MicroB will restore your chosen default
  84 browser.</p>
  85
  86 <p>If you experience trouble after installing the package, try rebooting
  87 your device.  If that fixes things, please report this as a bug.</p>
  88
  89 <h2>Documentation</h2>
  90 <p>See the
  91 <a href="http://git.maemo.org/projects/browser-switch/?p=browser-switch;a=blob_plain;f=README;hb=HEAD">README</a>
  92 for further instructions on how to configure and use Browser Switchboard.</p>
  93
  94 <h2>Support</h2>
  95 <p>You can email your question to the maintainers (see below), or you can take
  96 it to the
  97 <a href="http://talk.maemo.org/showthread.php?t=38273">Browser Switchboard thread</a>
  98 on the talk.maemo.org forums.</p>
  99
 100 <h2>Development</h2>
 101 <p>The latest source is available via a Git repository; you can check it out
 102 by running</p>
 103 <pre>
 104 git clone https://git.maemo.org/projects/browser-switch
 105 </pre>
 106 <p>from a shell. You can also
 107 <a href="http://git.maemo.org/projects/browser-switch/?p=browser-switch;a=summary">browse the repository</a> using gitweb.</p>
 108
 109 <p>Bug reports and patches can be emailed to the maintainers, or posted on the
 110 forum thread.</p>
 111
 112 <h2>Maintainers</h2>
 113 <p>Steven Luo
 114 &lt;<a href="mailto:steven+maemo [at] steven676.net">steven+maemo [at] steven676.net</a>&gt;
 115 is the primary maintainer of Browser Switchboard, with assistance from Jason
 116 Simpson (the original developer).</p>
 117 </body>
 118
 119 </html>