WiFi Radar
by Ahmad Baitalmal <ahmad@baitalmal.com>

WiFi Radar isi a PyGTK2 utility for managing WiFi profiles.
----------------------------------------------------------------------------------------------------
** Quick Usage
	- To do a quick scan and connect to any available profile
	# wifi-radar -d

	- To show the UI and manage profiles
	# wifi-radar
----------------------------------------------------------------------------------------------------
I. Here is what is important:
    * It will always look for the config file in /etc/conf.d/wifi-radar.conf.
	  You can change that in wifi-radar
    * If the conf file does not exist, it will create it, so you must always run
	  it within a correctly permitted account (as root or use sudo)
    * Running it with the "--daemon" or "-d" option will set it to "scan and auto
	  connect" mode, which has no UI (good for running at boot time or in the background).

	You can change everything from the conf file which is simply a .ini file.
	To change the location of the .conf file change it in wifi-radar.
	If you have questions, post them to the Linux Forum at the X1000 Forums site
	(http://www.x1000forums.com/index.php?showforum=8).
	You can always get the latest version from http://www.bitbuilder.com/wifi_radar.
	The SVN repository is available at http://svn.bitbuilder.com

----------------------------------------------------------------------------------------------------
II. No compile or make, if you have python installed and pygtk2 then you are set. I don't know if 
you are on X1000 Linux (or gentoo) but this is how you would install it correctly.

	* Move wifi-radar to /usr/sbin and make it executable
	  chmod +x wifi-radar
	
	* If you are going to use sudo, you can use the included wifi-radar.sh shell wrapper.
	  Put it in /usr/bin

	* Call it at boot time
      edit your /etc/conf.d/local.start and add the line to call it with the --daemon option
      /usr/sbin/wifi-radar --daemon
      That will scan and auto connect you to a preffered network (if you have one configured).

	* In Gnome (or X or KDE) create a launcher for the shell wrapper
	  /usr/bin/wifi-radar.sh
	  That will bring up the GUI so you can create profiles (or scan).

I included an svg and png icons so you can add it to the gnome panel as a launcher.

----------------------------------------------------------------------------------------------------
III. Remember, always run it as root or use sudo. Or you can follow these instructions if sudo is 
not something you are comfortable with.
* Integrating with gnome 
  by Flipp Bunts <flipp.bunts@gmail.com>:
	how to get wifi-radar custom launcher to use pam authentication in gnome
        1. get wifi-radar and untar
        2. put wifi-radar.svg in /usr/share/pixmaps
        3. put wifi-radar.py in /usr/local/bin
        4. ln -s /usr/bin/consolehelper /usr/local/bin/wifi-radar
        5. vi /etc/security/console.apps/wifi-radar
                USER=root
                PROGRAM=/usr/local/bin/wifi-radar.py
                SESSION=true
        6. vi /etc/pam.d/wifi-radar
                #%PAM-1.0
                auth       sufficient   pam_rootok.so
                auth       sufficient   pam_timestamp.so
                auth       required     pam_stack.so service=system-auth
                session    required     pam_permit.so
                session    optional     pam_xauth.so
                session    optional     pam_timestamp.so
                account    required     pam_permit.so
        7. check the permissions
                sh-3.00# ls -lh /etc/security/console.apps/wifi-radar /etc/pam.d/wifi-radar
                -rw-r--r--  1 root root  /etc/pam.d/wifi-radar
                -rw-r--r--  1 root root  /etc/security/console.apps/wifi-radar
        8. add launcher
                a. right click on panel
                b. select 'add to panel'
                c. click on 'custom application launcher'
                d. options for 'create launcher'
                name : wifi-radar
                command : /usr/local/bin/wifi-radar
                icon : /usr/share/pixmap/wifi-radar.svg
        9. click on the icon, enter the root password, away you go
----------------------------------------------------------------------------------------------------

WiFi Radar is released under the GPL license.
Have fun.
Ahmad Baitalmal <ahmad@baitalmal.com>
