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 <p>Browser Switchboard (formerly browser-proxy) is a program which allows
  13 you to choose which browser to use as the default browser on Maemo devices.
  14 It supports MicroB, Tear, Fennec/Mobile Firefox, and Midori out of the box,
  15 and can also be used to launch MicroB without having browserd running.</p>
  16
  17 <h2>Current Release</h2>
  18 <p>Version 3.0rc1 (2009/12/18) (<a href="https://garage.maemo.org/frs/download.php/7081/browser-switchboard_3.0rc1-1_armel.deb">Diablo package</a>)</p>
  19 <ul>
  20 <li>Release candidate -- not (yet) a stable release</li>
  21 <li>Add a control panel applet to help configure the UI</li>
  22 <li>Reimplement the core D-Bus proxy in C to improve speed and memory footprint</li>
  23 <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>
  24 <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>
  25 </ul>
  26 <p>Version 2.2 (2009/12/14) (<a href="https://garage.maemo.org/frs/download.php/7038/browser-switchboard_2.2-1_all.deb">Diablo package</a>)</p>
  27 <ul>
  28 <li>Rename the package to browser-switchboard</li>
  29 <li>Move the config file to /home/user/.config/browser-switchboard, and
  30 fall back to the old location if no config file is found</li>
  31 <li>If no config file is found and Tear isn't installed, launch MicroB;
  32 this avoids breaking link opening on a system with a freshly installed
  33 browser-switchboard package and Tear not installed</li>
  34 <li>Package no longer depends on Tear; should make it easier for users of
  35 other alternative browsers to use Browser Switchboard</li>
  36 <li>substantial documentation update</li>
  37 </ul>
  38
  39 <h2>Getting Browser Switchboard</h2>
  40 <p>Source code, packages for Diablo, and EXPERIMENTAL packages for Fremantle
  41 can be found on the maemo Garage
  42 <a href="https://garage.maemo.org/frs/?group_id=1159">download page</a>.
  43 Packages can also be installed from the maemo
  44 <a href="http://wiki.maemo.org/Extras-devel">extras-devel repository</a>
  45 (though don't blindly enable extras-devel and install/upgrade &mdash; see
  46 the linked page first!)</p>
  47
  48 <h2>Quick Start</h2>
  49 <ol>
  50 <li>Download the binary package: browser-switchboard_X.Y-Z_all.deb
  51 (where X.Y-Z is the version number, of course).</li>
  52 <li>Install the package using the Application Manager (on Diablo, open the
  53 Application Manager, then select Application->Install from file in the
  54 menu).</li>
  55 </ol>
  56
  57 <p><img src="cpapplet-diablo.jpg" width=320 alt="Browser Switchboard control panel UI"><br>
  58 You can now select the default browser by using the Browser Switchboard
  59 applet in the Control Panel.  Links in most applications, locally-saved
  60 web pages opened from the file manager, and (for Maemo 4.x) entries in
  61 the Web sidebar panel will open in the browser that you select as the
  62 default.  If you don't configure a default browser, MicroB will continue
  63 to be used as the default browser.</p>
  64
  65 <p>No matter which browser you select as the default, MicroB can always be
  66 opened via the Web menu entry in the applications menu (for Maemo 4.x,
  67 located in the Internet menu by default), or by running "browser" from
  68 the shell.  While MicroB is open, it will receive all links from other
  69 applications; closing MicroB will restore your chosen default browser.</p>
  70
  71 <p>Some users have reported that a restart may be necessary to ensure that
  72 Browser Switchboard is functioning.  If you experience trouble after
  73 installing the package, try rebooting your device first.</p>
  74
  75 <h2>Documentation</h2>
  76 <p>See the
  77 <a href="https://git.maemo.org/projects/browser-switch/?p=browser-switch;a=blob_plain;f=README;hb=HEAD">README</a>
  78 for further instructions on how to configure and use Browser Switchboard.</p>
  79
  80 <h2>Support</h2>
  81 <p>You can email your question to the maintainers (see below), or you can take
  82 it to the
  83 <a href="http://talk.maemo.org/showthread.php?t=28539">Tear thread</a>
  84 on the talk.maemo.org forums.</p>
  85
  86 <h2>Development</h2>
  87 <p>The latest source is available via a Git repository; you can check it out
  88 by running</p>
  89 <pre>
  90 git clone https://git.maemo.org/projects/browser-switch
  91 </pre>
  92 <p>from a shell. You can also
  93 <a href="https://git.maemo.org/projects/browser-switch/?p=browser-switch;a=summary">browse the repository</a> using gitweb.</p>
  94
  95 <p>Bug reports and patches can be emailed to the maintainers, or posted on the
  96 forum thread.</p>
  97
  98 <h2>Maintainers</h2>
  99 <p>Steven Luo
 100 &lt;<a href="mailto:steven+maemo [at] steven676.net">steven+maemo [at] steven676.net</a>&gt;
 101 is the primary maintainer of Browser Switchboard, with assistance from Jason
 102 Simpson (the original developer).</p>
 103 </body>
 104
 105 </html>