{"id":24113515,"url":"https://github.com/ezhil56x/deauther","last_synced_at":"2025-02-28T08:47:52.981Z","repository":{"id":205163150,"uuid":"713570627","full_name":"ezhil56x/deauther","owner":"ezhil56x","description":"Wi-Fi Deauther is a command-line utility for educational purposes, enabling users to perform Wi-Fi network actions such as scanning, deauthentication, and monitoring. Use responsibly and comply with applicable laws.","archived":false,"fork":false,"pushed_at":"2023-11-02T20:18:48.000Z","size":11,"stargazers_count":29,"open_issues_count":0,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-23T03:48:59.897Z","etag":null,"topics":["cybersecurity","cybersecurity-projects","wifi-deauth","wifi-deauther"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ezhil56x.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}},"created_at":"2023-11-02T19:42:23.000Z","updated_at":"2025-02-01T09:59:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"31ea47be-f47c-40a3-bf37-5979139edb7b","html_url":"https://github.com/ezhil56x/deauther","commit_stats":null,"previous_names":["ezhil56x/deauther"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezhil56x%2Fdeauther","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezhil56x%2Fdeauther/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezhil56x%2Fdeauther/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezhil56x%2Fdeauther/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ezhil56x","download_url":"https://codeload.github.com/ezhil56x/deauther/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241126088,"owners_count":19913953,"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":["cybersecurity","cybersecurity-projects","wifi-deauth","wifi-deauther"],"created_at":"2025-01-11T04:03:39.352Z","updated_at":"2025-02-28T08:47:52.955Z","avatar_url":"https://github.com/ezhil56x.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Deauther\r\n\r\n## Disclaimer ⚠️\r\n\r\nThis tool is provided for educational purposes only. It should not be used for illegal activities. Only use it for legitimate penetration testing and security research purposes and network devices that you own or have permission to test. By using this tool, you agree that you will not engage in any unauthorized or illegal activities with it. You understand that the misuse of this tool may violate laws and regulations and can lead to severe legal consequences, including criminal charges and penalties. The author of this tool shall not be held responsible for any damages or liabilities caused by the use or misuse of this tool. Use this tool at your own risk and with proper authorization. Ensure compliance with applicable laws and obtain necessary permissions before using it.\r\n\r\n## Introduction\r\n\r\nDeauther is a command-line utility designed for educational purposes, allowing you to perform various actions related to Wi-Fi networks. This tool is intended for legitimate penetration testing, security research purposes, and network devices that you own or have permission to test.\r\n\r\n## Pre-requisites\r\n\r\n- Linux Environment\r\n- [Python 3](https://www.python.org/downloads/)\r\n- [Aircrack-ng](https://www.aircrack-ng.org/downloads.html)\r\n\r\n## Installation\r\n\r\n1. Clone the repository\r\n\r\n```\r\ngit clone https://github.com/ezhil56x/deauther.git\r\n```\r\n\r\n2. Move the repository\r\n\r\n```\r\nsudo mv deauther /opt\r\n```\r\n\r\n3. Create a symbolic link\r\n\r\n```\r\nsudo ln -s /opt/deauther/deauther /usr/local/bin/deauther\r\n```\r\n\r\n4. Make the tool executable\r\n\r\n```\r\nsudo chmod +x /opt/deauther/deauther\r\n```\r\n\r\n## Options\r\n\r\n| Option                          | Description                                     |\r\n| ------------------------------- | ----------------------------------------------- |\r\n| `-h` or `--help`                | Show help message and exit                      |\r\n| `--mode=\u003cmode\u003e `                | Specify the mode to use                         |\r\n| `--interface=\u003cinterface\u003e`       | Specify the Wi-Fi interface                     |\r\n| `--time=\u003ctime\u003e`                 | Specify the time you want to scan               |\r\n| `--channel=\u003cchannel\u003e`           | Specify the channel number of the Wi-Fi network |\r\n| `--access-point=\u003caccess-point\u003e` | Specify the access point MAC to use             |\r\n| `--client=\u003cclient\u003e`             | Specify the client MAC to use                   |\r\n| `--number=\u003cnumber\u003e`             | Specify the number to packets to send           |\r\n\r\n## Modes of Operation\r\n\r\n| Mode            | Description                                           |\r\n| --------------- | ----------------------------------------------------- |\r\n| `scan_wns`      | Scan for Wi-Fi networks                               |\r\n| `list_aps`      | List available Wi-Fi networks                         |\r\n| `scan_ap`       | Scan for clients connected to a Wi-Fi network         |\r\n| `list_clients`  | List clients connected to a Wi-Fi network             |\r\n| `deauth_all`    | Deauthenticate all clients from a Wi-Fi network       |\r\n| `deauth_client` | Deauthenticate a specific client from a Wi-Fi network |\r\n\r\n## Usage\r\n\r\n### Scan Wi-Fi networks\r\n\r\n```\r\nsudo deauther --mode=scan_wns --interface=wlan0 --time=120\r\n```\r\n\r\n### List available Wi-Fi networks\r\n\r\n```\r\nsudo deauther --mode=list_aps\r\n```\r\n\r\n### Scan a Wi-Fi network for clients\r\n\r\n```\r\nsudo deauther --mode=scan_ap --interface=wlan0 --channel=6 --access-point=FF:FF:FF:FF:FF:FF --time=120\r\n```\r\n\r\n### List clients connected to a Wi-Fi network\r\n\r\n```\r\nsudo deauther --mode=list_clients\r\n```\r\n\r\n### Deauthenticate all clients from a Wi-Fi network\r\n\r\n```\r\nsudo deauther --mode=deauth_all --interface=wlan0 --access-point=FF:FF:FF:FF:FF:FF --number=10000\r\n```\r\n\r\n### Deauthenticate a specific client from a Wi-Fi network\r\n\r\n```\r\nsudo deauther --mode=deauth_client --interface=wlan0 --access-point=FF:FF:FF:FF:FF:FF --client=FF:FF:FF:FF:FF:FF --number=10000\r\n```\r\n\r\n## License\r\n\r\nThis tool is licensed under the [MIT License](https://github.com/ezhil56x/deauther/blob/main/LICENSE)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fezhil56x%2Fdeauther","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fezhil56x%2Fdeauther","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fezhil56x%2Fdeauther/lists"}