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 is a program which allows you to choose which
  19 browser to use as the default browser. It supports MicroB, Tear,
  20 Mobile Firefox, Opera Mobile, and Midori out of the box, and can also be
  21 used to launch MicroB without having browserd running.  A Control Panel
  22 applet to choose the default browser is provided.</p>
  23
  24 <h2>Current Release</h2>
  25 <p>Version 3.3 (2010/09/02) (<a href="browser-switchboard.install">Diablo one-click install</a>, <a href="https://garage.maemo.org/frs/download.php/8765/browser-switchboard_3.3-1fremantle1_armel.deb">Beta-quality Fremantle package</a>)</p>
  26 <ul>
  27 <li>In the Control Panel applet, only offer browsers that are actually installed.</li>
  28 <li>Fall back to MicroB instead of silently failing if the configured default browser is not installed.</li>
  29 <li>[Fremantle] An overhaul of the MicroB launching process, which should greatly increase the robustness of Browser Switchboard with MicroB on Fremantle.  When MicroB is selected as the default browser, the user experience should be identical to that when Browser Switchboard isn't installed; MicroB will still behave differently when another browser is selected as the default (see the known issues for details).</li>
  30 <li>Listen on the D-Bus system bus as well as the session bus, to accommodate applications (like some versions of Hermes and witter) which send link opening requests on the system bus.  (Application developers: the system bus isn't for user programs, you should be using the session bus.)</li>
  31 <li>[Diablo] Continuous mode is now the default mode of operation.</li>
  32 <li>[Fremantle] Continuous mode is now forced on regardless of the setting of the config preference; this change is required to make sure applications can find us on the system bus.</li>
  33 <li>[Fremantle] Browser Switchboard is now started on startup; this change is required to make sure applications can find us on the system bus.</li>
  34 <li>[Fremantle] By default, MicroB is now prestarted on startup, and remains in memory even when no browser windows are open, if MicroB is the default browser.  This behavior can be configured via a new autostart_microb preference.</li>
  35 <li>Update the package description to mention that there's a control panel applet in the package, to help out users who don't read documentation (and therefore won't find this thread).  Thanks to Emanuele Cassioli for the suggestion.</li>
  36 <li>Rename the MicroB option in the control panel to "MicroB (stock browser)", as some have pointed out that the MicroB name isn't used anywhere and is therefore not familiar to many users.  Better wording suggestions are welcome.</li>
  37 <li>Provide a command-line tool for configuring Browser Switchboard which can be used by browser developers to set their browser as the default.  See the <a href="http://git.maemo.org/git/browser-switch/?p=browser-switch;a=commit;h=6ac42ed781a7735221de8aaa28a6647b32608049">commit message</a> for more information.  This interface isn't set in stone, so if you have comments, please let me know.</li>
  38 </ul>
  39
  40 <h2>Getting Browser Switchboard</h2>
  41 <p><b>For Diablo/Maemo 4.1</b>, the recommended way to install Browser
  42 Switchboard is via the Maemo
  43 <a href="http://wiki.maemo.org/Extras">Extras repository</a>,
  44 which is enabled by default in the Application Manager.
  45 You should find Browser Switchboard in the Application Manager catalog under
  46 the network category.  Alternately, if you're viewing this page on your Diablo
  47 device, opening the <a href="browser-switchboard.install">one-click install</a>
  48 will install the package from Maemo Extras for you.</p>
  49 <p>Source code and packages can also be found on the Maemo Garage
  50 <a href="https://garage.maemo.org/frs/?group_id=1159">download page</a>.</p>
  51
  52 <p><b>For Fremantle/Maemo 5</b>, beta-quality packages and source code
  53 can be found on the Maemo Garage
  54 <a href="https://garage.maemo.org/frs/?group_id=1159">download page</a>.
  55 Packages can also be installed from the Maemo
  56 <a href="http://wiki.maemo.org/Extras-testing">extras-testing repository</a>
  57 (though don't blindly enable extras-testing and install/upgrade &mdash; see
  58 the linked page first!)</p>
  59
  60 <h2>Quick Start</h2>
  61 <p><b>For Diablo/Maemo 4.1</b>, just open the
  62 <a href="browser-switchboard.install">one-click install</a> in a browser on
  63 your device and follow the instructions to install Browser Switchboard.</p>
  64 <p><b>For Fremantle/Maemo 5</b>, or if you want to install the package by hand:</p>
  65 <ol>
  66 <li>Download the binary package: browser-switchboard_X.Y-Z_all.deb
  67 (where X.Y-Z is the version number, of course).</li>
  68 <li>Install the package using the Application Manager.</li>
  69 </ol>
  70
  71 <p><img src="cpapplet-diablo.jpg" width=320 alt="Browser Switchboard control panel UI"><br>
  72 You can now select the default browser by using the Browser Switchboard
  73 applet in the Control Panel.  Links in most applications, locally-saved
  74 web pages opened from the file manager, and (for Maemo 4.x) entries in
  75 the Web sidebar panel will open in the browser that you select as the
  76 default.  Opening the "Web" menu entry and running "browser" from the
  77 shell will also cause your chosen default browser to open.  If you don't
  78 configure a default browser, MicroB will continue to be used as the
  79 default browser.</p>
  80
  81 <p>No matter which browser you select as the default, MicroB can always be
  82 opened via the MicroB menu entry in the applications menu (for Maemo
  83 4.x, installed in the Extras menu by default), or by running "microb"
  84 from the shell.  While MicroB is open, it will receive all links from
  85 other applications; closing MicroB will restore your chosen default
  86 browser.</p>
  87
  88 <p>If you experience trouble after installing the package, try rebooting
  89 your device.  If that fixes things, please report this as a bug.</p>
  90
  91 <h2>Documentation</h2>
  92 <p>See the
  93 <a href="http://git.maemo.org/projects/browser-switch/?p=browser-switch;a=blob_plain;f=README;hb=HEAD">README</a>
  94 for further instructions on how to configure and use Browser Switchboard.</p>
  95
  96 <h2>Support</h2>
  97 <p>You can email your question to the maintainers (see below), or you can take
  98 it to the
  99 <a href="http://talk.maemo.org/showthread.php?t=38273">Browser Switchboard thread</a>
 100 on the talk.maemo.org forums.</p>
 101
 102 <h2>Development</h2>
 103 <p>The latest source is available via a Git repository; you can check it out
 104 by running</p>
 105 <pre>
 106 git clone https://git.maemo.org/projects/browser-switch
 107 </pre>
 108 <p>from a shell. You can also
 109 <a href="http://git.maemo.org/projects/browser-switch/?p=browser-switch;a=summary">browse the repository</a> using gitweb.</p>
 110
 111 <p>Bug reports and patches can be emailed to the maintainers, or posted on the
 112 forum thread.</p>
 113
 114 <h2>Maintainers</h2>
 115 <p>Steven Luo
 116 &lt;<a href="mailto:steven+maemo [at] steven676.net">steven+maemo [at] steven676.net</a>&gt;
 117 is the primary maintainer of Browser Switchboard, with assistance from Jason
 118 Simpson (the original developer).</p>
 119 </body>
 120
 121 </html>