{"id":13473824,"url":"https://github.com/aress31/wirespy","last_synced_at":"2025-04-04T22:06:49.402Z","repository":{"id":48126235,"uuid":"49780727","full_name":"aress31/wirespy","owner":"aress31","description":"Framework designed to automate various wireless networks attacks (the project was presented on Pentester Academy TV's toolbox in 2017).","archived":false,"fork":false,"pushed_at":"2022-10-15T22:58:54.000Z","size":308,"stargazers_count":601,"open_issues_count":5,"forks_count":89,"subscribers_count":38,"default_branch":"master","last_synced_at":"2024-10-21T05:50:14.557Z","etag":null,"topics":["aircrack-ng","evil-twin","eviltwin","honeypot","hotspot","man-in-the-middle","man-in-the-middle-attack","mitm","monitoring","pentesting","wifi","wifi-hacking","wifi-security","wireless","wireless-security"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/aress31.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"aress31","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2016-01-16T16:16:38.000Z","updated_at":"2024-10-20T11:02:03.000Z","dependencies_parsed_at":"2022-08-12T19:10:30.344Z","dependency_job_id":null,"html_url":"https://github.com/aress31/wirespy","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aress31%2Fwirespy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aress31%2Fwirespy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aress31%2Fwirespy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aress31%2Fwirespy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aress31","download_url":"https://codeload.github.com/aress31/wirespy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247256112,"owners_count":20909240,"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":["aircrack-ng","evil-twin","eviltwin","honeypot","hotspot","man-in-the-middle","man-in-the-middle-attack","mitm","monitoring","pentesting","wifi","wifi-hacking","wifi-security","wireless","wireless-security"],"created_at":"2024-07-31T16:01:07.216Z","updated_at":"2025-04-04T22:06:49.381Z","avatar_url":"https://github.com/aress31.png","language":"Shell","funding_links":["https://github.com/sponsors/aress31"],"categories":["Uncategorized","\u003ca id=\"d4efda1853b2cb0909727188116a2a8c\"\u003e\u003c/a\u003e未分类-WiFi","Tools","HarmonyOS"],"sub_categories":["Uncategorized","\u003ca id=\"37ca6907aa42dfd32db5973ff9eec83d\"\u003e\u003c/a\u003e新添加的","Windows Manager"],"readme":"# wirespy\n\n\u003ca href=\"https://www.gnu.org/software/bash/\"\u003e\u003cimg alt=\"language\" src=\"https://img.shields.io/badge/Lang-Bash%204.2+-blue.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opensource.org/licenses/Apache-2.0\"\u003e\u003cimg alt=\"license\" src=\"https://img.shields.io/badge/License-Apache%202.0-red.svg\"\u003e\u003c/a\u003e\n\u003cimg alt=\"version\" src=\"https://img.shields.io/badge/Version-0.6-green.svg\"\u003e\n\n## WireSpy enables the automation of various WiFi attacks to conduct Man-In-The-Middle-Attacks (MITMAs).\n\n**WireSpy** allows attackers to set up quick honeypots to carry out **MITMAs**. Monitoring and logging functionality is implemented in order to keep records of the victims' traffic/activities. Other tools can be used together with Wirespy to conduct more advanced attacks.\n\nTwo type of attacks are supported at the moment:\n\n- **Evil twin**: Force victims to auto-connect to the honeypot by spoofing a _\"trusted\"_ hotspot (clone an existing access point and de-authenticate its users to force them to transparently connect to the spoofed honeypot).\n- **Honeypot**: Set up a simple rogue hotspot and wait for clients to connect.\n\n## Features\n\n- Capture victims' traffic.\n- MAC address spoofing.\n- Set-up honeypot and evil twin attacks.\n- Show the list of in range access points.\n- Wireless adapter|card|dongle power amplification.\n\n## Usage\n\n1. Set as `executable`:\n\n   ```bash\n   chmod +x wirespy.sh\n   ```\n\n2. Execute as `root`:\n\n   ```bash\n   sudo ./wirespy.sh\n   ```\n\n3. Type `help` to get started.\n\n   ```bash\n   Attacks:\n       eviltwin      \u003e launch an evil twin attack\n       honeypot      \u003e launch a rogue access point attack\n\n   Commands:\n       clear         \u003e clear the terminal\n       help          \u003e list available commands\n       quit|exit     \u003e exit the program\n       apscan        \u003e show all wireless access points nearby\n       leases        \u003e display DHCP leases\n       powerup       \u003e power wireless interface up (may cause issues)\n       start capture \u003e start packet capture (tcpdump)\n       stop capture  \u003e stop packet capture (tcpdump)\n       status        \u003e show modules status\n   ```\n\n## Roadmap\n\n- [ ] Add WPA/WPA2 support for honeypot.\n- [ ] Bash autocompletion.\n- [x] Optimise the source code.\n- [x] Improve the stability.\n- [x] Improve the UI (e.g. uniformise the style and colors).\n- [x] Show the status of processes running in the background.\n- [ ] Validate all user inputs against regexes.\n\n## Project Information\n\nThis script was developed in the context of my [master thesis work](https://www.slideshare.net/AlexandreTeyar/security-in-mobile-banking-apps-154409860) in June 2015.\n\nThe project was presented on Pentester Academy TV's toolbox in 2017:\n\n[![Pentester Academy TV's toolbox](https://img.youtube.com/vi/ALSChHZdf5o/0.jpg)](https://www.youtube.com/watch?v=ALSChHZdf5o)\n\nWork on a new improved version has commenced in 2018.\n\n## Sponsor 💖\n\nIf you want to support this project and appreciate the time invested in developping, maintening and extending it; consider donating toward my next cup of coffee. ☕\n\nIt is easy, all you got to do is press the `Sponsor` button at the top of this page or alternatively [click this link](https://github.com/sponsors/aress31). 💸\n\n## Reporting Issues\n\nFound a bug? I would love to squash it! 🐛\n\nPlease report all issues on the GitHub [issues tracker](https://github.com/aress31/wirespy/issues).\n\n## Contributing\n\nYou would like to contribute to better this project? 🤩\n\nPlease submit all `PRs` on the GitHub [pull requests tracker](https://github.com/aress31/wirespy/pulls).\n\n## License\n\nSee [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faress31%2Fwirespy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faress31%2Fwirespy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faress31%2Fwirespy/lists"}