{"id":27009874,"url":"https://github.com/streanger/clients-scanner","last_synced_at":"2025-12-13T18:19:32.533Z","repository":{"id":62562643,"uuid":"267072431","full_name":"streanger/clients-scanner","owner":"streanger","description":"Local network clients scanner with deauth feature","archived":false,"fork":false,"pushed_at":"2024-08-09T18:21:56.000Z","size":739,"stargazers_count":5,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-21T17:40:24.725Z","etag":null,"topics":["deauth","deauth-wifi","deauthentication-attack","local-network","scanner","tkinter-python","wifi","wifi-scanner"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/clients-scanner/","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/streanger.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2020-05-26T14:54:13.000Z","updated_at":"2024-11-23T20:49:43.000Z","dependencies_parsed_at":"2025-05-29T12:42:44.428Z","dependency_job_id":"ed6a353d-dbbb-4feb-bb79-6673d445118a","html_url":"https://github.com/streanger/clients-scanner","commit_stats":{"total_commits":18,"total_committers":1,"mean_commits":18.0,"dds":0.0,"last_synced_commit":"7ace9314f7fe34034d4985a34d11b3ce4163879f"},"previous_names":["streanger/clients_scanner"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/streanger/clients-scanner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/streanger%2Fclients-scanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/streanger%2Fclients-scanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/streanger%2Fclients-scanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/streanger%2Fclients-scanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/streanger","download_url":"https://codeload.github.com/streanger/clients-scanner/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/streanger%2Fclients-scanner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279010480,"owners_count":26084757,"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","status":"online","status_checked_at":"2025-10-12T02:00:06.719Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["deauth","deauth-wifi","deauthentication-attack","local-network","scanner","tkinter-python","wifi","wifi-scanner"],"created_at":"2025-04-04T10:52:57.153Z","updated_at":"2025-10-12T06:15:14.899Z","avatar_url":"https://github.com/streanger.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"clients-scanner\n======================\nLocal network clients scanner with deauth feature\n\n.. image:: https://raw.githubusercontent.com/streanger/clients-scanner/master/images/scanner.png\n\nInfo\n======================\n- while creating app I was inspired by Android Fing application\n- application shows local network devices\n- discovered devices are stored in clients.json file under home directory\n- application allows to perform deauthentication(disconnecting devices connected over WiFi)\n- deauthentication bases on: https://github.com/roglew/wifikill\n- icons by Icons8: https://icons8.com/\n- sounds comes from: https://mixkit.co/\n\nInstall\n======================\n\n.. code-block:: python\n\n    pip install clients-scanner\n\nor\n\n.. code-block:: bash\n\n    pip install git+https://github.com/streanger/clients-scanner.git\n\n**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\n\nWindows:\n\n.. code-block:: bash\n\n    # Npcap -\u003e https://npcap.com/#download\n    # Winpcap -\u003e https://www.winpcap.org/install/\n    # or Npcap included in nmap using command:\n    choco install nmap -y\n\nLinux\n\n.. code-block:: bash\n\n    sudo apt-get install libpcap-dev\n\n**Important**: you may need to run script as sudo under Linux to work properly\n\nUsage\n======================\n\nMain scanner gui\n\n.. code-block:: python\n\n    # from Python\n    from clients_scanner import scanner\n    scanner()\n\n.. code-block:: bash\n\n    # from command-line\n    scanner\n\nScapyScanner\n\n.. code-block:: python\n\n    from clients_scanner import ScapyScanner\n    scapy_scanner = ScapyScanner()\n\n    # get clients directly\n    clients = scapy_scanner.get_clients('192.168.0.1/24', timeout=2)\n    for (IP, mac) in clients:\n        print(IP, mac)\n\n    # get enriched clients data from queue\n    scapy_scanner.run()\n    while True:\n        item = scapy_scanner.clients_queue.get()\n        print(item)\n        # Client(mac='XXXX', ip='XXXX', bssid='XXXX', ssid='XXXX', time=XXXX)\n\nDeauthenticator\n\n.. code-block:: python\n\n    from clients_scanner import Deauthenticator\n    deauth = Deauthenticator(gateway_ip='192.168.0.1', gateway_mac='aa:bb:cc:dd:ee:ff')\n    deauth.run()\n    victim_ip = '192.168.0.123'\n    victim_mac = 'aa:bb:cc:dd:ee:ff'\n    status = False\n    deauth.deauth_queue.put((victim_mac, victim_ip, status))\n\nChangelog\n======================\n- `v. 0.1.2`\n\n  - reshaped gui\n  - night mode\n  - scan on/off mode\n  - debug mode\n  - \"removing clients\" feature\n  - scrollable area\n  - more friendly sound\n  - config files in user home directory\n\n- `v. 0.1.0 - 0.1.1`\n\n  - gui with limited rows number\n  - deauth feature\n  \nIssues\n======================\n\nIf you encounter anny issue, error, bug or you want to enchant project, please describe it `in issues section \u003chttps://github.com/streanger/clients-scanner/issues\u003e`_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstreanger%2Fclients-scanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstreanger%2Fclients-scanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstreanger%2Fclients-scanner/lists"}