{"id":18574517,"url":"https://github.com/minemetero/hello-ips","last_synced_at":"2025-05-16T00:10:32.581Z","repository":{"id":253244917,"uuid":"842920785","full_name":"Minemetero/Hello-IPs","owner":"Minemetero","description":"U r in my sight!","archived":false,"fork":false,"pushed_at":"2025-05-08T10:31:34.000Z","size":680,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-05-08T10:31:48.062Z","etag":null,"topics":["arp","arp-poisoning","arp-scan","arp-spoofing","device-blocking","hacking","lan","network","network-attack","network-scanner-python","networkscanner","portscanner","scapy","wifi"],"latest_commit_sha":null,"homepage":"","language":"Python","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/Minemetero.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2024-08-15T11:50:46.000Z","updated_at":"2025-05-08T10:31:37.000Z","dependencies_parsed_at":"2025-04-17T12:33:56.988Z","dependency_job_id":"13b9914b-7419-43c4-889f-b2a6b496a098","html_url":"https://github.com/Minemetero/Hello-IPs","commit_stats":null,"previous_names":["minemetero/hello-ips"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Minemetero%2FHello-IPs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Minemetero%2FHello-IPs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Minemetero%2FHello-IPs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Minemetero%2FHello-IPs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Minemetero","download_url":"https://codeload.github.com/Minemetero/Hello-IPs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254442856,"owners_count":22071878,"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":["arp","arp-poisoning","arp-scan","arp-spoofing","device-blocking","hacking","lan","network","network-attack","network-scanner-python","networkscanner","portscanner","scapy","wifi"],"created_at":"2024-11-06T23:15:41.088Z","updated_at":"2025-05-16T00:10:32.564Z","avatar_url":"https://github.com/Minemetero.png","language":"Python","readme":"# Hello-IPs\n\n## Table of Contents\n- [Installation](#installation)\n- [Overview](#overview)\n- [Features](#features)\n- [Project Structure](#project-structure)\n- [Usage](#usage)\n- [License](#license)\n- [Disclaimer](#disclaimer)\n- [Contributing](#contributing)\n\n## Installation\n\n### Windows Users (Easiest Method)\n1. **Download and Run:**\n   - Go to the [Releases](https://github.com/Minemetero/Hello-IPs/releases) page\n   - Download the latest `Hello-IPs.exe` file\n   - Simply double-click to run the application\n   - If Windows SmartScreen appears, click \"More info\" and then \"Run anyway\"\n\n### macOS Users\n1. **Download and Run:**\n   - Go to the [Releases](https://github.com/Minemetero/Hello-IPs/releases) page\n   - Download the latest `Hello-IPs.exe` file\n   - Double-click to run the application\n\n### Linux Users\n1. **Clone the Repository:**\n   ```bash\n   git clone https://github.com/Minemetero/Hello-IPs.git\n   cd Hello-IPs\n   ```\n\n2. **Create and Activate a Virtual Environment:**\n   ```bash\n   python -m venv venv\n   source venv/bin/activate\n   ```\n\n3. **Install Dependencies:**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **Run the Application:**\n   ```bash\n   python main.py\n   ```\n\n\u003e [!TIP]\n\u003e **If you run into any issues during installation or usage, please open an issue on GitHub or contact the maintainers.**\n\n## Overview\n\n**Hello-IPs** is a user-friendly, GUI-based network scanning and device blocking tool designed for local area networks (LANs). The tool features an intuitive graphical interface that makes network management accessible to all users. Simply double-click the executable on Windows to get started.\n\nThe tool concurrently discovers devices via ARP scanning and gathers rich information about each device including its IP address, MAC address, vendor (via OUI mapping), device name (from reverse DNS and nbtstat), and an optional list of open ports. Additionally, Hello-IPs offers multiple experimental methods to block unauthorized devices.\n\n\u003e [!WARNING]\n\u003e This software is intended for use **only on networks you administrate**.  \n\u003e The blocking methods provided are experimental and may disrupt network communications.  \n\u003e Use this tool at your own risk; the author disclaims all liability for misuse.\n\n## Features\n\n- **Concurrent Scanning:**  \n  Scans each /24 subnet concurrently to speed up device discovery.\n  \n- **Rich Device Information:**  \n  Retrieves IP, MAC, vendor, device name, and optionally probes common open ports (e.g., 22, 23, 80, 443, 3389).\n\n- **Multiple Blocking Options:**  \n  Choose from seven methods:\n  - ARP Poisoning\n  - ARP Flooding\n  - ARP Tornado (experimental)\n  - MAC Flooding (experimental)\n  - ICMP Unreachable (experimental)\n  - TCP SYN Flood (experimental)\n  - DNS Amplification (experimental)\n\n- **User-Friendly GUI:**  \n  Built with Tkinter, the interface features a clear control layout.\n\n## Project Structure\n\n```\nproject_root/\n ├── data/\n │    └── nmap-mac-prefixes.txt   # Vendor mapping file\n ├── output/                      # Folder for generated output (e.g., ipconfig output)\n ├── network_scanner/\n │    ├── __init__.py\n │    ├── scanner.py              # Network scanning \u0026 utility functions\n │    ├── block.py                # Device blocking functions\n │    ├── probe.py                # Optional probing functions\n │    ├── gui.py                  # GUI for scanning and blocking\n │    └── utils/                  # Utility modules\n │         ├── __init__.py\n │         ├── logger.py          # Common logging system\n │         ├── log_saver.py       # Saving logs\n │         ├── file_saver.py      # Save scan results\n │         └── file_viewer.py     # View the file results\n ├── main.py                      # Application entry point\n └── requirements.txt             # Python dependencies\n```\n\n## Usage\n\n1. **Using the GUI:**\n   - Click **\"Scan Network\"** to start scanning.\n   - The table will display discovered devices along with IP, MAC, vendor, device name, and open ports.\n   - To block a device, select it from the table, choose a blocking method from the dropdown (seven options available), and specify a duration.\n   - Click **\"Block Selected Device\"** to initiate the blocking process.\n\n## License\n\nThis project is licensed under the [Apache License 2.0](LICENSE). All copyright remains with the author. The software is provided \"AS IS\" without warranties, and the user assumes full responsibility for any misuse or illegal activity arising from its use.\n\n## Disclaimer\n\n\u003e [!WARNING]\n\u003e Hello-IPs is designed for authorized network management only. The blocking methods, particularly the experimental ones (ARP Tornado, MAC Flooding, and ICMP Unreachable), may severely disrupt network communications. Use them only on networks you administrate. The author disclaims all liability for any illegal or improper use of this software.\n\n## Contributing\n\nContributions are welcome. Please fork the repository and submit a pull request with your enhancements or bug fixes.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminemetero%2Fhello-ips","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fminemetero%2Fhello-ips","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminemetero%2Fhello-ips/lists"}