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="browser-switchboard-fremantle.install">Fremantle one-click install</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>The recommended way to install Browser Switchboard is via the Maemo
  42 <a href="http://wiki.maemo.org/Extras">Extras repository</a>,
  43 which is enabled by default in the Application Manager.
  44 You should find Browser Switchboard in the Application Manager catalog under
  45 the network category.  Alternately, if you're viewing this page on your Maemo
  46 device, opening the <a href="browser-switchboard.install">one-click install</a>
  47 will install the package from Maemo Extras for you.</p>
  48 <p>Source code and packages can also be found on the Maemo Garage
  49 <a href="https://garage.maemo.org/frs/?group_id=1159">download page</a>.</p>
  50
  51 <h2>Quick Start</h2>
  52 <p>Just open the <a href="browser-switchboard.install">one-click install</a> in
  53 a browser on your device and follow the instructions to install Browser
  54 Switchboard.</p>
  55 <p>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.  Opening the "Web" menu entry and running "browser" from the
  68 shell will also cause your chosen default browser to open.  If you don't
  69 configure a default browser, MicroB will continue to be used as the
  70 default browser.</p>
  71
  72 <p>No matter which browser you select as the default, MicroB can always be
  73 opened via the MicroB menu entry in the applications menu (for Maemo
  74 4.x, installed in the Extras menu by default), or by running "microb"
  75 from the shell.  While MicroB is open, it will receive all links from
  76 other applications; closing MicroB will restore your chosen default
  77 browser.</p>
  78
  79 <p>If you experience trouble after installing the package, try rebooting
  80 your device.  If that fixes things, please report this as a bug.</p>
  81
  82 <h2>Documentation</h2>
  83 <p>See the
  84 <a href="http://git.maemo.org/projects/browser-switch/?p=browser-switch;a=blob_plain;f=README;hb=HEAD">README</a>
  85 for further instructions on how to configure and use Browser Switchboard.</p>
  86
  87 <h2>Support</h2>
  88 <p>You can email your question to the maintainers (see below), or you can take
  89 it to the
  90 <a href="http://talk.maemo.org/showthread.php?t=38273">Browser Switchboard thread</a>
  91 on the talk.maemo.org forums.</p>
  92
  93 <h2>Development</h2>
  94 <p>The latest source is available via a Git repository; you can check it out
  95 by running</p>
  96 <pre>
  97 git clone https://git.maemo.org/projects/browser-switch
  98 </pre>
  99 <p>from a shell. You can also
 100 <a href="http://git.maemo.org/projects/browser-switch/?p=browser-switch;a=summary">browse the repository</a> using gitweb.</p>
 101
 102 <p>Bug reports and patches can be emailed to the maintainers, or posted on the
 103 forum thread.</p>
 104
 105 <h2>Maintainers</h2>
 106 <p>Steven Luo
 107 &lt;<a href="mailto:steven+maemo [at] steven676.net">steven+maemo [at] steven676.net</a>&gt;
 108 is the primary maintainer of Browser Switchboard, with assistance from Jason
 109 Simpson (the original developer).</p>
 110 </body>
 111
 112 </html>