{"id":15715944,"url":"https://github.com/angela-d/wifi-network-testing","last_synced_at":"2025-07-12T19:38:14.309Z","repository":{"id":112030391,"uuid":"441581440","full_name":"angela-d/wifi-network-testing","owner":"angela-d","description":"Scan your wifi network and obtain troubleshooting details, with extreme granularity - using a colorful command-line tool.","archived":false,"fork":false,"pushed_at":"2024-02-20T01:47:36.000Z","size":3989,"stargazers_count":90,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-15T11:07:54.348Z","etag":null,"topics":["airport","bash","bash-script","brew","gplv3","homebrew","internet-access","internet-connectivity","macos","monitoring","network-manager","nmcli","shell-scripts","wifi","wifi-monitor","wifi-network","wifi-scanner","wifi-security","wireless","wireless-network"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/angela-d.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-25T01:10:09.000Z","updated_at":"2025-03-05T02:28:47.000Z","dependencies_parsed_at":"2024-10-24T12:59:25.560Z","dependency_job_id":"069b5760-5d12-420f-8855-6bd52f92b369","html_url":"https://github.com/angela-d/wifi-network-testing","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/angela-d%2Fwifi-network-testing","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/angela-d%2Fwifi-network-testing/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/angela-d%2Fwifi-network-testing/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/angela-d%2Fwifi-network-testing/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/angela-d","download_url":"https://codeload.github.com/angela-d/wifi-network-testing/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249058369,"owners_count":21205910,"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":["airport","bash","bash-script","brew","gplv3","homebrew","internet-access","internet-connectivity","macos","monitoring","network-manager","nmcli","shell-scripts","wifi","wifi-monitor","wifi-network","wifi-scanner","wifi-security","wireless","wireless-network"],"created_at":"2024-10-03T21:43:31.463Z","updated_at":"2025-04-15T11:08:08.421Z","avatar_url":"https://github.com/angela-d.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wifi Network Testing\nScan your wifi network and obtain troubleshooting details, with extreme granularity; using a colorful command-line tool with no technical skill necessary.   (Assuming you are familiar with git, of course.)\n\n**Obtain the following details about your wifi connection**:\n\nWifi statistics:\n- SSID / wifi name / access point / router name you're connected to\n- MAC address \u0026 manufacturer details\n- Channel details; connection cipher/encryption for your connection\n- Neighbor details:\n  - Nearby router / access point signal strength (in relation to you)\n  - Their router MAC \u0026 chip manufacturer info\n  - SSID (wifi name) and overall neighbor channel utilization\n  - What channel each router or AP is using\n  - How many routers/APs total are on that channel\n\nConnectivity assessments:\n- Connection detection\n- Speed tests \u0026 packet loss\n- IP \u0026 DNS information\n- VPN detection\n\n**Optional, built-in enterprise capabilities:**\n\nUseful in scenarios where you're in a multi-access point environment; several APs carrying the same SSID but are posted in different locations throughout your campus.\n\n- Determine whether or not you're on your organization's network / intranet\n- Assign custom AP names to access points/routers at your organization (useful when determining which access point in your building is causing issues, such as channel overlap or evil twin attacks)\n\n**Compatible Operating Systems**\n\n| OS            | Pre-prerequisite | Auto-Install (if not already in-use)?                     |\n| ------------- |:----------------:| ---------------------------------:|\n| Debian-based Linux | network-manager/nmcli | :ballot_box_with_check: |\n| MacOS              | brew                  | :ballot_box_with_check: |\n| Windows 10         | Git, Bash             | :x: [[details]](https://github.com/angela-d/wifi-network-testing/wiki/Windows-Install)                |\n\n\n### Screenshots\n\n| Test Option / Install Step            | Image |\n| ------------- |:----------------:|\n| Initial Setup | \u003cimg src=\"img/initial-setup.png\" width=\"100\"\u003e |\n| Main Menu | \u003cimg src=\"img/main-menu.png\" width=\"100\"\u003e |\n| #2 (Extended: Basic + packet loss, IP \u0026 DNS information) | \u003cimg src=\"img/test2-extended.png\" width=\"100\"\u003e |\n| #3 (Basic + speed test only) | \u003cimg src=\"img/test3-speedtest.png\" width=\"100\"\u003e |\n| #5 (5g channel usage) | \u003cimg src=\"img/5g-test.png\" width=\"100\"\u003e |\n| #6 (Access point + channel usage) - appearance varies by OS; Linux looks the coolest | \u003cimg src=\"img/test6-linux.png\" width=\"100\"\u003e |\n| Channel lookup (Linux only) | \u003cimg src=\"img/channel-lookup.png\" width=\"100\"\u003e |\n\n\n### How to Install\n- [First Run Steps](https://github.com/angela-d/wifi-network-testing/wiki/First-Run/) - How to install and use wiki\n\n### Useful Companion Apps (optional)\nIf you find this tool useful, you might also find these handy (both are currently for Linux only):\n- [wavemon](https://github.com/uoaerg/wavemon) - ncurses-based monitoring application for wireless network devices on Linux\n- [wifi-channel-watcher](https://github.com/angela-d/wifi-channel-watcher) - Monitor channel usage of neighboring routers/access points \u0026 get an alert if your active channel is not optimal\n\n\n### Known Bugs\nThere's a few [cosmetic bugs](https://github.com/angela-d/wifi-network-testing/wiki/Known-Bugs/) that don't affect performance.\n\n### Credits\nOriginal iteration of this application was written by my super cool boss.\n\nI added cross-platform capabilities + enterprise AP customization, MAC lookups and channel details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fangela-d%2Fwifi-network-testing","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fangela-d%2Fwifi-network-testing","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fangela-d%2Fwifi-network-testing/lists"}