https://github.com/rofl0r/macgeiger
MacGeiger - a tool to track down the location of WIFI APs with sound (Geigercounter-like)
https://github.com/rofl0r/macgeiger
antenna color location ncurses signal sound wifi wifi-ap wifi-network
Last synced: 7 months ago
JSON representation
MacGeiger - a tool to track down the location of WIFI APs with sound (Geigercounter-like)
- Host: GitHub
- URL: https://github.com/rofl0r/macgeiger
- Owner: rofl0r
- License: gpl-3.0
- Created: 2014-07-31T16:28:18.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2021-04-16T16:18:15.000Z (over 4 years ago)
- Last Synced: 2025-03-18T08:41:27.108Z (7 months ago)
- Topics: antenna, color, location, ncurses, signal, sound, wifi, wifi-ap, wifi-network
- Language: C
- Homepage:
- Size: 182 KB
- Stars: 53
- Watchers: 9
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
MacGeiger - a WIFI AP locator utility
=====================================
this tool puts your wireless card into monitor mode, then processes beacon
frames from APs to create a list, in which you can navigate with the cursor
keys, then select one AP with `ENTER`. the AP will open in detail view and
start to beep. the faster it beeps, the better is the signal of the AP.
this is quite handy to adjust directional antennas for the perfect signal
without having to stare at a screen, which may be impractical.
it can also be used on a mobile linux device (think netbook) to move through
the streets and find the physical location of APs. you probably should wear
headphones to do so...
the keys `+`/`-` and `0`/`9` can be used to adjust the audio volume.
Dependencies
------------
3rd party dependencies (install them including headers, i.e. -dev package)
- libpcap :packet capturing library
- libao :audio output library
1st party dependencies
- rcb2 :build tool
- depends on python2
- concol :terminal library with ncurses,termbox and SDL backends
- depends on either SDL or ncurses devel package installed
how to build from release tarball:
----------------------------------
just run `make`. if you need to change variables, CFLAGS, etc, do so by
creating a file called `config.mak` and override the settings there.
you may also use it to change `BACKEND` to `SDL`.
by default the ncurses version will be built since it is assumed it is more
widely available.
Note: you may find release tarballs attached to git tags in the github repo.
how to build from git:
----------------------
paste this into your shell
mkdir /tmp/macgeiger-build
cd /tmp/macgeiger-build
for i in rcb2 concol macgeiger libulz ; do git clone git://github.com/rofl0r/$i ; done
mv libulz lib
ln -s rcb2.py rcb2/rcb2
cd macgeiger/
printf "%s\n%s\n" "CFLAGS+=-DCONSOLE_BACKEND=SDL_CONSOLE" "CFLAGS+=-DCONSOLE_FONT=INT10FONT14" > config.mak
PATH="$PATH:../rcb2" make
if you want to use the ncurses backend (which is much harder to debug using gdb),
replace SDL_CONSOLE with NCURSES_CONSOLE in the above printf command
alternatively you may use the `create-dist` script to create a source tarball
that does not require the rcb build tool.
rebuilding with a different console backend:
-------------------------------------------
if you decided to try another backend (not the previously used one), run
PATH="$PATH:../rcb2" RCBFLAGS=--new make
how to use:
-----------
./macgeiger.out wlan0mon
let the program gather network info for some seconds, then select an AP from the list
with cursor-up, cursor-down, then hit ENTER to track it with audio feedback.