{"id":41775508,"url":"https://github.com/twsnmp/twwifiscan","last_synced_at":"2026-04-01T20:02:32.954Z","repository":{"id":65193838,"uuid":"402556205","full_name":"twsnmp/twWifiScan","owner":"twsnmp","description":"Cross-platform WiFi scanner and analyzer written in Go. Captures IEEE 802.11 beacons and probes to visualize wireless environments.","archived":false,"fork":false,"pushed_at":"2026-03-20T20:51:25.000Z","size":721,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-21T10:26:09.344Z","etag":null,"topics":["80211","go","golang","network-tools","osint-tool","security-tools","sysadmin-tool","wifi-scanner"],"latest_commit_sha":null,"homepage":"https://twsnmp.github.io/twWifiScan/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/twsnmp.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-09-02T20:36:06.000Z","updated_at":"2026-03-20T21:02:14.000Z","dependencies_parsed_at":"2024-06-20T04:21:39.248Z","dependency_job_id":"3c97be7c-b75d-4485-b1f6-a410c1167459","html_url":"https://github.com/twsnmp/twWifiScan","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/twsnmp/twWifiScan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twsnmp%2FtwWifiScan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twsnmp%2FtwWifiScan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twsnmp%2FtwWifiScan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twsnmp%2FtwWifiScan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/twsnmp","download_url":"https://codeload.github.com/twsnmp/twWifiScan/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twsnmp%2FtwWifiScan/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31291344,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["80211","go","golang","network-tools","osint-tool","security-tools","sysadmin-tool","wifi-scanner"],"created_at":"2026-01-25T03:27:38.962Z","updated_at":"2026-04-01T20:02:32.944Z","avatar_url":"https://github.com/twsnmp.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# twWifiScan\nWifi AP sensor for TWSNMP FC\n\n[![Godoc Reference](https://godoc.org/github.com/twsnmp/twWifiScan?status.svg)](http://godoc.org/github.com/twsnmp/twWifiScan)\n[![Go Report Card](https://goreportcard.com/badge/twsnmp/twWifiScan)](https://goreportcard.com/report/twsnmp/twWifiScan)\n\n[日本語の説明](./README_ja.md)\n\n![](images/twWifiScan.png)\n\n\n## Overview\n\ntwWifiScan is a sensor program that collects information on wireless LAN access points in the surrounding area and sends it to TWSNMP FC, etc., via syslog or MQTT.\n\nIn the current version, the following information can be obtained:\n\n- Statistical information on monitored packets\n- Sensor resource usage\n- Wireless LAN access point details (BSSID, SSID, RSSI, Channel, Encryption, etc.)\n\n\n## Status\n\n- v1.0.0 released (2021/9/8): Initial release with basic functions.\n- v1.0.1 released (2021/10/31): macOS bug fix.\n- v1.1.0 released (2025/1/26): Automatic release.\n- v2.0.0 (Current): Integrated MQTT support and removed macOS dependencies.\n\n## Build\n\nBuild the project using the `make` command:\n\n```bash\n$ make\n```\n\nAvailable targets:\n\n```\n  all        Build all executable files (default)\n  clean      Delete the built executable files\n  zip        Create Zip files for distribution\n```\n\nRunning `make` creates executable files for Windows, Linux (AMD64), Linux (ARM), and Linux (ARM64) in the `dist` directory.\n\nTo create distribution zip files:\n\n```bash\n$ make zip\n```\n\n## Run\n\n### Usage\n\n```bash\nUsage of dist/twWifiScan:\n  -debug\n    \tEnable debug mode\n  -iface string\n    \tMonitor interface (default \"wlan0\")\n  -interval int\n    \tSend interval (sec) (default 600)\n  -mqtt string\n    \tMQTT broker URL\n  -mqttClientID string\n    \tMQTT client ID (default \"twWifiScan\")\n  -mqttPassword string\n    \tMQTT password\n  -mqttTopic string\n    \tMQTT topic prefix (default \"twWifiScan\")\n  -mqttUser string\n    \tMQTT user\n  -syslog string\n    \tSyslog destination list\n```\n\nSyslog destinations can be specified as a comma-separated list. You can also specify the port number after a colon.\n\n```bash\n-syslog 192.168.1.1,192.168.1.2:5514\n```\n\nTo start, a monitoring LAN I/F (`-iface`) and a destination (`-syslog` or `-mqtt`) are required.\n\nExample (Linux):\n\n```bash\n# ./twWifiScan -iface wlan0 -syslog 192.168.1.1 -mqtt tcp://broker.example.com:1883\n```\n\n## Data Format\n\n### Syslog\nThe transmitted syslog message uses the `local5` facility with the tag `twWifiScan`.\n\nExample (APInfo):\n```\ntype=APInfo,ssid=F660T-VFyM-X,bssid=FC:C8:97:B0:xx:D5,rssi=-73,Channel=1,info=Encrypt;802.11i/WPA2 Version 1,count=9593,change=0,vendor=zte,ft=2024-12-06T15:48:57+09:00,lt=2025-01-26T16:38:57+09:00\n```\n\n### MQTT\nMessages are published in JSON format to topics based on the `mqttTopic` prefix:\n- `\u003cmqttTopic\u003e/APInfo`\n- `\u003cmqttTopic\u003e/WifiScanStats`\n- `\u003cmqttTopic\u003e/Monitor`\n\n## License\n\nSee [LICENSE](./LICENSE).\n\n```\nCopyright 2021-2026 Masayuki Yamai\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftwsnmp%2Ftwwifiscan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftwsnmp%2Ftwwifiscan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftwsnmp%2Ftwwifiscan/lists"}