3 # vi:set filetype=conf:
7 --------------------------------------------------------------------------------
9 Maintained by Brian Elliott Finley <brian@thefinleys.com>
10 Created by Ahmad Baitalmal <ahmad@baitalmal.com>
12 http://wifi-radar.systemimager.org/
14 WiFi Radar is released under the GPL license.
18 --------------------------------------------------------------------------------
20 To do a quick scan and connect to any available profile:
25 To show the GUI and manage profiles:
30 Nifty Config Tip for Ubuntu and Debian Based Distributions
31 --------------------------------------------------------------------------------
33 After initial configuration of your preferred wifi networks by
34 runing the wifi-radar GUI, you can automatically invoke wifi-radar
35 as part of your systems standard ifup/ifdown proceedures.
37 Find a stanza in /etc/network/interfaces for your wifi device (or
38 create one), and modify it so that it looks like this example:
41 iface eth1 inet static
46 When you or your system does an "ifup eth1", this stanza will set a
47 temporary static IP address (that should not conflict with
48 anything), then invoke wifi-radar in daemon mode which will connect
49 to a preferred wifi network and configure your interface
50 accordingly, with an IP address appropriate for that network.
54 I. Here are Some Important Bits:
55 --------------------------------------------------------------------------------
57 * The config file defaults to /etc/wifi-radar/wifi-radar.conf. The
58 location of this file can be changed at install time with
61 "make install sysconfdir=/etc/wifi-radar"
63 * If the conf file does not exist, it will be created at run-time, so you must
64 always invoke wifi-radar as root or with sudo.
66 * Running wifi-radar with the "--daemon" or "-d" option will set it
67 to "scan and auto connect" mode, which has no UI (good for running
68 at boot time or in the background).
70 * You can change everything else from the conf file which is simply
73 If you have questions, post them to the Linux Forum at the X1000
74 Forums site (http://www.x1000forums.com/index.php?showforum=8).
78 --------------------------------------------------------------------------------
85 --------------------------------------------------------------------------------
87 1. Type "sudo make install"
88 (or "sudo make install sysconfdir=/etc/wifi-radar")
91 IV. HOWTO: Optional PAM Configuration
92 --------------------------------------------------------------------------------
94 These instructions allow you to run wifi-radar as a normal user
95 without using sudo. Thanks to Flipp Bunts <flipp.bunts@gmail.com>
98 HOWTO get wifi-radar custom launcher to use PAM authentication in
100 1. get wifi-radar and untar
101 2. put wifi-radar.svg in /usr/share/pixmaps
102 3. put wifi-radar.py in /usr/local/bin
103 4. ln -s /usr/bin/consolehelper /usr/local/bin/wifi-radar
104 5. vi /etc/security/console.apps/wifi-radar
106 PROGRAM=/usr/local/bin/wifi-radar.py
108 6. vi /etc/pam.d/wifi-radar
110 auth sufficient pam_rootok.so
111 auth sufficient pam_timestamp.so
112 auth required pam_stack.so service=system-auth
113 session required pam_permit.so
114 session optional pam_xauth.so
115 session optional pam_timestamp.so
116 account required pam_permit.so
117 7. check the permissions
118 # ls -lh /etc/security/console.apps/wifi-radar /etc/pam.d/wifi-radar
119 -rw-r--r-- 1 root root /etc/pam.d/wifi-radar
120 -rw-r--r-- 1 root root /etc/security/console.apps/wifi-radar
122 a. right click on panel
123 b. select 'add to panel'
124 c. click on 'custom application launcher'
125 d. options for 'create launcher'
127 command : /usr/local/bin/wifi-radar
128 icon : /usr/share/pixmap/wifi-radar.svg
129 9. click on the icon, enter the root password, away you go