Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
A Perl script for monitoring wireless networks under Linux. Think of it as a poor man's Netstumbler (not that Netstumbler is expensive, but it does require Windows) http://www.oak-wood.co.uk/2010/07/pif…
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Type||Name||Latest commit message||Commit time|
|Failed to load latest commit information.|
Pifimon is a Perl script for monitoring wireless access points under Linux. It relies on iwlist, part of the wirelesstools package. It parses the output of iwlist and presents the results in a neater way. On launching it presents a continuously updating list of visible access points. One AP can then be selected to display a histogram of signal strength. Pifimon provides a means to extend it to support different wireless card drivers or versions of iwlist. See Drivers/README. Usage ===== pifimon [-v][-d driver] [interface] pifimon [-d driver] file filename -d use a driver from the Drivers directory. driver is the filename without the .pm extension -v print version and exit interface is the interface to monitor. Default values for both driver and interface can be set by changing the values of $default_driver and $default_if in the configuration file. This file is named 'config' and should be in the same directory as pifimon. An example is included as config.dist. *NB* because `iwlist scan` requires root priviliges, Pifimon must also be run as root. The specialcase pifimon [-d driver] file filename allows a simulated scan to be run using the file 'filename' as the input. This should be a dump of iwlist output. This was added to allow drivers for additional cards to be developed without needing access to the card *Cell list screen* The cell list screen displays a list of all cells that have been seen since Pifimon was started, or since the list was reset. Cells not currently visible will have no signal strength reported. Enter a cell number followed by enter/return to monitor that cell and display a histogram of its signal strength. Press one of the following keys for other actions: L - toggle looping (continuous updating of the cell list) R - reset the list N - view the next screen in the list, if the list extends over more than one screen P - view the previous screen in the list Q - quit *Histogram screen* The histogram screen displays a histogram representing the signal strength for the chosen cell. Signal strength is given, either in dBm or as a percentage, depending on the driver. Press Q to quit and return to the cell list screen. Requirements ============ A linux system with working wireless card iwlist Perl CPAN modules: Required: Term::ReadKey (Ubuntu package: libterm-readkey-perl) Installation ============ Make sure your system meets the requirements (see above). If you need to install CPAN modules use something like cpan Term::ReadKey Or on Ubuntu you can install the package with apt-get apt-get install libterm-readkey-perl Then unpack the tarball, eg: tar -xzvf tipichris-pifimon-xxxxx.tar.gz or tar -xzvf pifimon-xxx.tar.gz Change into the directory you just unpacked to and make sure the script is executable; eg cd pifimon-xxx chmod 755 pifimon Then run the script with ./pifimon That's about it. --- Copyright 2010 Chris Hastie (http://www.oak-wood.co.uk/) Concept inspired by scanmeter: http://www.skifactz.com/wifi/Linux_Antenna_Tuning.htm Perl parsing of iwlist output based on Timothy Mills' wiscan.pl: http://jintoreedwine.wordpress.com/2008/08/04/how-i-shortened-the-iwlist-scan-output/ Pifimon is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. Pifimon is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with Pifimon. If not, see <http://www.gnu.org/licenses/>.