Editing Wifi Assistant
Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
+ | <h1>Wifi Jail Breakout Assistant</h1> | ||
+ | |||
[[Image:Wifi-assistant-icon.png]] | [[Image:Wifi-assistant-icon.png]] | ||
This page is about the application known as Wifi Assistant. | This page is about the application known as Wifi Assistant. | ||
- | |||
- | |||
- | |||
- | |||
- | |||
+ | =About= | ||
+ | ==What?== | ||
+ | |||
+ | This application aims to help make life easier when connecting your Nokia N900 to wifi networks (WLAN) that requires you to visit a captive portal (login) page before you can access the Internet. | ||
+ | |||
+ | |||
+ | ==Why?== | ||
+ | |||
+ | I got tired of not being able to connect easily to networks guarded by a login page, so I created this app to scratch that itch. Nokia doesn't supply this feature and when asked for, it's out of scope for the N900. | ||
+ | |||
+ | =How it works and Screenshots= | ||
- | + | ==Connected to network== | |
- | + | ||
- | + | ||
- | + | ||
- | When you're connected to a "new" network, you get this popup which asks you if you want to launch a browser. 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), | + | When you're connected to a "new" network, you get this popup which asks you if you want to launch a browser. |
+ | 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.) | unless you untick the "Remember this decision" checkbox. (You'd get the same popup each time instead.) | ||
- | [[Image:wifi-assistant-screenshot-popup.jpg | + | [[Image:wifi-assistant-screenshot-popup.jpg]] |
- | + | ||
- | + | ||
- | 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. | + | |
+ | ==Network Settings== | ||
+ | |||
+ | 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. | ||
- | [[Image:wifi-assistant-screenshot-launch-list.png | + | [[Image:wifi-assistant-screenshot-launch-list.png]] |
- | [[Image:wifi-assistant-screenshot-launch-settings.png | + | [[Image:wifi-assistant-screenshot-launch-settings.png]] |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | 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 | + | |
- | + | ==Daemon Settings== | |
- | + | ||
- | + | 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. | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | [[Image:wifi-assistant-screenshot-daemon-settings.png]] | |
+ | |||
+ | =Download and Install= | ||
+ | |||
+ | Get the debian package file (wifi-assistant_X.X.X_all.deb) from | ||
+ | [http://maemo.org/packages/view/wifi-assistant/ the Maemo.org packages site] | ||
+ | If you download the file using your browser, the application manager will start and you'll be asked to install the pacakge. | ||
+ | |||
+ | Eventually you'll be able to download Wifi Assistant from the Extras repository, provided by Nokia/Maemo. | ||
+ | |||
+ | If you want to use the terminal, the commands are (requires root shell (rootsh) and wget): | ||
+ | $ sudo gainroot | ||
+ | # wget https..... | ||
+ | # dpkg -i wifi-assistant_latest.deb | ||
+ | |||
+ | ==Alternative== | ||
+ | |||
You could also get the latest version from | You could also get the latest version from | ||
- | [https://garage.maemo.org/projects/wifi-assistant this projects' garage (home)]. This is where I put the packages I test myself. It should not differ at all from the ones built by the Maemo build site. | + | [https://garage.maemo.org/projects/wifi-assistant this projects' garage (home)]. |
- | + | This is where I put the packages I test myself. It should not differ at all from the ones built by the Maemo build site. | |
- | + | ||
- | + | ||
+ | =Roadmap= | ||
* <del>Daemon that launches browser</del> | * <del>Daemon that launches browser</del> | ||
* <del>GUI app where you can change settings</del> | * <del>GUI app where you can change settings</del> | ||
Line 66: | Line 79: | ||
** Change listenting to changes in gconf to using dbus (only if this consumes less power) | ** Change listenting to changes in gconf to using dbus (only if this consumes less power) | ||
* Implement Ideas (below) | * Implement Ideas (below) | ||
- | + | ||
- | + | ||
+ | |||
+ | =Bugs= | ||
Comes included from the start ... | Comes included from the start ... | ||
Line 78: | Line 93: | ||
Either way - your contribution is greatly appreciated! | Either way - your contribution is greatly appreciated! | ||
- | + | ||
- | + | ||
- | + | ||
+ | |||
+ | =Source= | ||
+ | |||
It's all written in Python and the source is available for download - you can either get it with | It's all written in Python and the source is available for download - you can either get it with | ||
- | < | + | <code>git clone https://vcs.maemo.org/git/wifi-assistant</code> or |
[https://garage.maemo.org/plugins/ggit/browse.php/?p=wifi-assistant browse it online]. | [https://garage.maemo.org/plugins/ggit/browse.php/?p=wifi-assistant browse it online]. | ||
+ | |||
+ | Contributions are of course very welcome! | ||
- | |||
- | |||
- | |||
+ | =License= | ||
+ | |||
This application is free to use, inspect, adapt and share, licensed under a BSD type license. | This application is free to use, inspect, adapt and share, licensed under a BSD type license. | ||
- | + | ||
- | + | ||
+ | =Thanks= | ||
To Lisa, Anton and Leia who support me (kind of) while I'm up late etc. | To Lisa, Anton and Leia who support me (kind of) while I'm up late etc. | ||
- | A big thanks to Andrew Flegg (Jaffa) - the build files for this application are extremely similar to those used to build the excellent anti "blue man syndrome" application [http://hermes.garage.maemo.org/ Hermes]. | + | A big thanks to Andrew Flegg (Jaffa) - the build files for this application are extremely similar to those used to build the excellent anti "blue man syndrome" application [http://hermes.garage.maemo.org/ Hermes]. |
- | + | ||
- | + | ||
- | + | =Donate= | |
You could either simply donate via PayPal, or Flattr this project - either way: thanks for your support! | You could either simply donate via PayPal, or Flattr this project - either way: thanks for your support! | ||
[[Image:Flattr-badge-large.png|link=http://flattr.com/thing/41709/Wifi-Jail-Breakout-Assistant]] (if the link doesn't work, please use http://flattr.com/thing/41709/Wifi-Jail-Breakout-Assistant - MediaWiki awkwardness) | [[Image:Flattr-badge-large.png|link=http://flattr.com/thing/41709/Wifi-Jail-Breakout-Assistant]] (if the link doesn't work, please use http://flattr.com/thing/41709/Wifi-Jail-Breakout-Assistant - MediaWiki awkwardness) | ||
- | If you want me to directly implement a feature you can't live without - contact me and we'll see if I can find the time. | + | If you want me to directly implement a feature you can't live without - contact me and we'll see if I can find the time. |
+ | |||
+ | |||
+ | =Ideas= | ||
- | + | <dt>Detect login page when connected to new network | |
- | + | <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). | |
- | + | ||
- | 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) | + | <dt>Detect URL needed to autologin |
- | + | <dd>The best idea I have right now is to setup a local proxy. The way to operate this would be to: | |
- | + | ||
- | + | ||
- | The best idea I have right now is to setup a local proxy. The way to operate this would be to: | + | |
* "Open browser and record URLs" button clicked | * "Open browser and record URLs" button clicked | ||
* a HTTP proxy is setup, the browser is setup to use that proxy | * a HTTP proxy is setup, the browser is setup to use that proxy | ||
Line 122: | Line 142: | ||
* user looks at list of recorded URLs | * user looks at list of recorded URLs | ||
* user selects URL to use when being connected to this network next time | * user selects URL to use when being connected to this network next time | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | =More Screenshots= | |
- | + | ||
- | + | ||
- | + | ||
These are not really needed to explain how the program works. | These are not really needed to explain how the program works. | ||
+ | |||
+ | [[Image:wifi-assistant-screenshot-menu.png]] | ||
+ | |||
+ | [[Image:wifi-assistant-screenshot-delete.png]] | ||
- | + | [[Image:wifi-assistant-screenshot-launch-settings-empty.png]] | |
- | + | ||
- | + | ||
- | Image:wifi-assistant-screenshot-launch-settings-empty.png | + | |
- | + | ||
- | + | ||
- | [[ | + | [[Image:wifi-assistant-screenshot-about.png]] |
Learn more about Contributing to the wiki.