<html>
<head>
<title>Wifi Jail Breakout Assistant</title>
+<style>
+h2 { clear: both; }
+.screenshot { width: 400px; }
+dd { margin-bottom: 1em; }
+#roadmap li.done { text-decoration: line-through }
+.cli { margin-left: 3em; }
+</style>
</head>
<body>
<h1>Wifi Jail Breakout Assistant</h1>
</div>
+
+
+
+
<h2>About</h2>
<h3>What?</h3>
<p>
Nokia doesn't supply this feature and when asked for, it's out of scope for the N900.
</p>
+
+
+
+
<h2>How it works and Screenshots</h2>
<h3>Connected to network</h3>
<p>
Simply press Yes or No to open a new browser window.
The next time you connect to that network, the same action will be take (open or not open a browser window),
unless you untick the "Remember this decision" checkbox. (You'd get the same popup each time instead.)
-<div><img src='gfx/screenshot-popup.jpg' /></div>
+<div><img class='screenshot' src='gfx/screenshot-popup.jpg' /></div>
</p>
<h3>Network Settings</h3>
If you fire up the configuration/settings GUI (it's called Wifi Assistant and the icon looks like the one at the top this page)
you get a list of all the networks we've used and whether to launch a browser or not.
You can change the settings by tapping the line you want to change.
-<div><img src='gfx/screenshot-launch-list.png' /></div>
-<div><img src='gfx/screenshot-launch-settings.png' /></div>
+<div><img class='screenshot' src='gfx/screenshot-launch-list.png' /></div>
+<div><img class='screenshot' src='gfx/screenshot-launch-settings.png' /></div>
</p>
<h3>Daemon Settings</h3>
<p>
You can turn the daemon off (kind of) so that it won't show popups. It'll still open a new browser window when you connect to
networks where you've selected "Yes" previously.
-<div><img src='gfx/screenshot-daemon-settings.png' /></div>
+<div><img class='screenshot' src='gfx/screenshot-daemon-settings.png' /></div>
</p>
+
+
+
<h2>Download and Install</h2>
<p>
Get the debian package file (wifi-assistant_X.X.X_all.deb) from
<a href="https://garage.maemo.org/frs/?group_id=1777">the Files section</a>
at
<a href="https://garage.maemo.org/projects/wifi-assistant">this projects' garage (home)</a>.
-If you download the file using your browser, the phone
+If you download the file using your browser, the application manager will start and you'll be asked to install the pacakge.
</p>
-
-<h2>License</h2>
<p>
-This application is free to use, inspect, adapt and share, licensed under a BSD type license.
+Eventually you'll be able to download Wifi Assistant from the Extras repository, provided by Nokia/Maemo.
+</p>
+<p>
+If you want to use the terminal, the commands are (requires root shell (rootsh) and wget):
+<pre class='cli'>
+$ sudo gainroot
+# wget https.....
+# dpkg -i wifi-assistant_latest.deb
+</pre>
</p>
+
+
+
+<h2>Roadmap</h2>
+<ul id='roadmap'>
+ <li class='done'>Daemon that launches browser</li>
+ <li class='done'>GUI app where you can change settings</li>
+ <li>Add and remove settings</li>
+ <li>Handles SSID/Network names with spaces in them</li>
+ <li>Upload wifi-assistant to Extras, put up a note on maemo.org forum</li>
+ <li>Ability to specify URL to launch, per SSID/Network name</li>
+ <li>Detect if the net is locked down or not
+ (useful for networks which gives you one day access - you only want the browser launched once per day)</li>
+ <li>Have the network settings sorted alphabetically</li>
+ <li>Daemon work:
+ <ul>
+ <li>Let the GUI app launch daemon if it's not running</li>
+ <li>Change listenting to changes in gconf to using dbus</li>
+ </ul>
+ </li>
+ <li>Implement Ideas (below)</li>
+</ul>
+
+
+
+
<h2>Bugs</h2>
<p>
Comes included from the start ...
The only real "bug" right now is that network names with spaces in them aren't handled properly (they can't be part of a gconf key).
</p>
+
+
+
<h2>Source</h2>
<p>
Is available, get it with <code>git clone https://vcs.maemo.org/git/wifi-assistant</code> or
There's more info at the <a href="https://garage.maemo.org/scm/?group_id=1777">SCM page</a>.
</p>
+
+
+
+<h2>License</h2>
+<p>
+This application is free to use, inspect, adapt and share, licensed under a BSD type license.
+</p>
+
+
+
+
<h2>Thanks</h2>
<p>
To Lisa, Anton and Leia who support me (kind of) while I'm up late etc.
<a href='http://hermes.garage.maemo.org/'>Hermes</a>.
</p>
+
+
+
<h2>Donate</h2>
<div style='margin-right: 1em; float: left'>
<script type="text/javascript">
<p>
You could either simply donate to PayPal, or Flattr this project - either way: thanks for your support!
</p>
+
+
+
+
+
+<h2>Ideas</h2>
+<dl>
+<dt>Detect login page when connected to new network</dt>
+<dd>This is fairly easy to do - simply make a HTTP HEAD request for a known static resource on the web.
+If you get anything but a HTTP 200 in return, that network has a captive portal (or the connection was lost etc).</dd>
+
+<dt>Detect URL needed to autologin</dt>
+<dd>The best idea I have right now is to setup a local proxy. The way to operate this would be to:
+<ol>
+<li>"Open browser and record URLs" button clicked</li>
+<li>a HTTP proxy is setup, the browser is setup to use that proxy</li>
+<li>browser is launched</li>
+<li>user logs in at the portal page</li>
+<li>user switches to Wifi Assistant, clicks "Turn off URL recording"</li>
+<li>proxy is shut down, browser (system) settings reverted to previous settings</li>
+<li>user looks at list of recorded URLs</li>
+<li>user selects URL to use when being connected to this network next time</li>
+</ol>
+</dd>
+</dl>
+
+</body>
+</html>
\ No newline at end of file