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)
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Drivers
CHANGES
COPYING
README
config.dist
pifimon

README

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/>.