https://github.com/streanger/clients-scanner
Local network clients scanner with deauth feature
https://github.com/streanger/clients-scanner
deauth deauth-wifi deauthentication-attack local-network scanner tkinter-python wifi wifi-scanner
Last synced: 3 months ago
JSON representation
Local network clients scanner with deauth feature
- Host: GitHub
- URL: https://github.com/streanger/clients-scanner
- Owner: streanger
- License: mit
- Created: 2020-05-26T14:54:13.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-08-09T18:21:56.000Z (10 months ago)
- Last Synced: 2025-03-10T10:18:36.607Z (3 months ago)
- Topics: deauth, deauth-wifi, deauthentication-attack, local-network, scanner, tkinter-python, wifi, wifi-scanner
- Language: Python
- Homepage: https://pypi.org/project/clients-scanner/
- Size: 722 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.rst
- License: LICENSE.txt
Awesome Lists containing this project
README
clients-scanner
======================
Local network clients scanner with deauth feature
.. image:: https://raw.githubusercontent.com/streanger/clients-scanner/master/images/scanner.png
Info
======================
- while creating app I was inspired by Android Fing application
- application shows local network devices
- discovered devices are stored in clients.json file under home directory
- application allows to perform deauthentication(disconnecting devices connected over WiFi)
- deauthentication bases on: https://github.com/roglew/wifikill
- icons by Icons8: https://icons8.com/
- sounds comes from: https://mixkit.co/
Install
======================
.. code-block:: python
pip install clients-scanner
or
.. code-block:: bash
pip install git+https://github.com/streanger/clients-scanner.git
**Important**: scapy requires ``Npcap`` (https://npcap.com/#download) or ``Winpcap`` (https://www.winpcap.org/install/) on Windows and ``libpcap`` on Linux. Please install needed package manually
Windows:
.. code-block:: bash
# Npcap -> https://npcap.com/#download
# Winpcap -> https://www.winpcap.org/install/
# or Npcap included in nmap using command:
choco install nmap -y
Linux
.. code-block:: bash
sudo apt-get install libpcap-dev
**Important**: you may need to run script as sudo under Linux to work properly
Usage
======================
Main scanner gui
.. code-block:: python
# from Python
from clients_scanner import scanner
scanner()
.. code-block:: bash
# from command-line
scanner
ScapyScanner
.. code-block:: python
from clients_scanner import ScapyScanner
scapy_scanner = ScapyScanner()
# get clients directly
clients = scapy_scanner.get_clients('192.168.0.1/24', timeout=2)
for (IP, mac) in clients:
print(IP, mac)
# get enriched clients data from queue
scapy_scanner.run()
while True:
item = scapy_scanner.clients_queue.get()
print(item)
# Client(mac='XXXX', ip='XXXX', bssid='XXXX', ssid='XXXX', time=XXXX)
Deauthenticator
.. code-block:: python
from clients_scanner import Deauthenticator
deauth = Deauthenticator(gateway_ip='192.168.0.1', gateway_mac='aa:bb:cc:dd:ee:ff')
deauth.run()
victim_ip = '192.168.0.123'
victim_mac = 'aa:bb:cc:dd:ee:ff'
status = False
deauth.deauth_queue.put((victim_mac, victim_ip, status))
Changelog
======================
- `v. 0.1.2`
- reshaped gui
- night mode
- scan on/off mode
- debug mode
- "removing clients" feature
- scrollable area
- more friendly sound
- config files in user home directory
- `v. 0.1.0 - 0.1.1`
- gui with limited rows number
- deauth feature
Issues
======================
If you encounter anny issue, error, bug or you want to enchant project, please describe it `in issues section `_