{"id":16842572,"url":"https://github.com/rofl0r/macgeiger","last_synced_at":"2025-03-22T05:31:09.379Z","repository":{"id":19241412,"uuid":"22476487","full_name":"rofl0r/MacGeiger","owner":"rofl0r","description":"MacGeiger - a tool to track down the location of WIFI APs with sound (Geigercounter-like)","archived":false,"fork":false,"pushed_at":"2021-04-16T16:18:15.000Z","size":186,"stargazers_count":53,"open_issues_count":1,"forks_count":11,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-03-18T08:41:27.108Z","etag":null,"topics":["antenna","color","location","ncurses","signal","sound","wifi","wifi-ap","wifi-network"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rofl0r.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-07-31T16:28:18.000Z","updated_at":"2025-02-12T00:01:10.000Z","dependencies_parsed_at":"2022-08-01T03:47:54.758Z","dependency_job_id":null,"html_url":"https://github.com/rofl0r/MacGeiger","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rofl0r%2FMacGeiger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rofl0r%2FMacGeiger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rofl0r%2FMacGeiger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rofl0r%2FMacGeiger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rofl0r","download_url":"https://codeload.github.com/rofl0r/MacGeiger/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244912800,"owners_count":20530764,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["antenna","color","location","ncurses","signal","sound","wifi","wifi-ap","wifi-network"],"created_at":"2024-10-13T12:46:48.067Z","updated_at":"2025-03-22T05:31:07.534Z","avatar_url":"https://github.com/rofl0r.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"MacGeiger - a WIFI AP locator utility\n=====================================\n\nthis tool puts your wireless card into monitor mode, then processes beacon\nframes from APs to create a list, in which you can navigate with the cursor\nkeys, then select one AP with `ENTER`. the AP will open in detail view and\nstart to beep. the faster it beeps, the better is the signal of the AP.\n\nthis is quite handy to adjust directional antennas for the perfect signal\nwithout having to stare at a screen, which may be impractical.\n\nit can also be used on a mobile linux device (think netbook) to move through\nthe streets and find the physical location of APs. you probably should wear\nheadphones to do so...\n\nthe keys `+`/`-` and `0`/`9` can be used to adjust the audio volume.\n\nDependencies\n------------\n\n3rd party dependencies (install them including headers, i.e. -dev package)\n- libpcap :packet capturing library\n- libao   :audio output library\n\n1st party dependencies\n- rcb2     :build tool\n  - depends on python2\n- concol  :terminal library with ncurses,termbox and SDL backends\n  - depends on either SDL or ncurses devel package installed\n\nhow to build from release tarball:\n----------------------------------\n\njust run `make`. if you need to change variables, CFLAGS, etc, do so by\ncreating a file called `config.mak` and override the settings there.\nyou may also use it to change `BACKEND` to `SDL`.\nby default the ncurses version will be built since it is assumed it is more\nwidely available.\n\nNote: you may find release tarballs attached to git tags in the github repo.\n\nhow to build from git:\n----------------------\n\npaste this into your shell\n\n    mkdir /tmp/macgeiger-build\n    cd /tmp/macgeiger-build\n    for i in rcb2 concol macgeiger libulz ; do git clone git://github.com/rofl0r/$i ; done\n    mv libulz lib\n    ln -s rcb2.py rcb2/rcb2\n    cd macgeiger/\n    printf \"%s\\n%s\\n\" \"CFLAGS+=-DCONSOLE_BACKEND=SDL_CONSOLE\" \"CFLAGS+=-DCONSOLE_FONT=INT10FONT14\" \u003e config.mak\n    PATH=\"$PATH:../rcb2\" make\n\nif you want to use the ncurses backend (which is much harder to debug using gdb),\nreplace SDL_CONSOLE with NCURSES_CONSOLE in the above printf command\n\nalternatively you may use the `create-dist` script to create a source tarball\nthat does not require the rcb build tool.\n\nrebuilding with a different console backend:\n-------------------------------------------\nif you decided to try another backend (not the previously used one), run\n\n    PATH=\"$PATH:../rcb2\" RCBFLAGS=--new make\n\nhow to use:\n-----------\n\n    ./macgeiger.out wlan0mon\n\nlet the program gather network info for some seconds, then select an AP from the list\nwith cursor-up, cursor-down, then hit ENTER to track it with audio feedback.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frofl0r%2Fmacgeiger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frofl0r%2Fmacgeiger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frofl0r%2Fmacgeiger/lists"}