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