██╗ ██╗██╗ ██╗ ███████╗ ██████╗ █████╗ ███╗ ██╗███╗ ██╗███████╗██████╗
██║ ██║╚██╗██╔╝ ██╔════╝██╔════╝██╔══██╗████╗ ██║████╗ ██║██╔════╝██╔══██╗
███████║ ╚███╔╝█████╗ ███████╗██║ ███████║██╔██╗ ██║██╔██╗ ██║█████╗ ██████╔╝
██╔══██║ ██╔██╗╚════╝ ╚════██║██║ ██╔══██║██║╚██╗██║██║╚██╗██║██╔══╝ ██╔══██╗
██║ ██║██╔╝ ██╗ ███████║╚██████╗██║ ██║██║ ╚████║██║ ╚████║███████╗██║ ██║
╚═╝ ╚═╝╚═╝ ╚═╝ ╚══════╝ ╚═════╝╚═╝ ╚═╝╚═╝ ╚═══╝╚═╝ ╚═══╝╚══════╝╚═╝ ╚═╝
HyperScanner is a powerful and futuristic HTTP status code scanner that takes a list of IPs or URLs and classifies their responses into structured folders and files.
Designed for speed, clarity, and beauty, HyperScanner simplifies HTTP response analysis with an organized and efficient workflow.
- 🔍 Scan IP & URLs Lists: Quickly scans any list of IPs or URLs and fetches their HTTP status codes.
- 🗂️ Organized Output: Automatically creates folder structures based on HTTP status codes (1xx, 2xx, 3xx, 4xx, 5xx).
- 📁 File-Based Response Storage: Saves each response into categorized files, such as
200.txtfor HTTP 200 OK responses. - ✅ Detailed Logs: Cleanly tracks results:
ip_exist.txt: List of valid and reachable IPs/URLs.ip_invalid.txt: List of invalid or unreachable IPs/URLs.log.txt: Comprehensive full scanning log.
- 🎨 Enhanced CLI (Terminal Output): Color-coded status codes for better readability (upcoming: icons + detailed categories).
- 🌐 CORS Integration (New!): Detects and logs CORS headers like
Access-Control-Allow-Origin. - 💻 Cross-Platform: Works flawlessly on Windows, Linux, and macOS.
Make sure you have Go 1.19+ installed.
Then install HyperScanner using:
go install github.com/hx-corp/hxscanner@latestPrepare a text file (ips.txt) containing a list of IPs or URLs, one per line.
Run HyperScanner with:
hxscanner -i ips.txtYou can also specify an output directory:
hxscanner -i ips.txt -o my_results| Option | Description |
|---|---|
-i <file> |
Input file with targets (IPs/Domains/URLs), one per line (required if -f not used) |
-f <file> |
Alias for -i |
-w <number> |
Number of concurrent scanning workers (default: number of CPU cores) |
-t <duration> |
HTTP request timeout (default: 5s) |
-q |
Quiet mode: suppress individual results (except errors/warnings) |
--cors |
Perform basic CORS vulnerability check on successful targets |
-h |
Show this help message |
HyperScanner organizes the output beautifully:
output/
├── 1xx/
│ └── 100.txt
├── 2xx/
│ ├── 200.txt
│ ├── 204.txt
│ └── ...
├── 3xx/
│ └── 301.txt
├── 4xx/
│ └── 404.txt
├── 5xx/
│ └── 500.txt
├── ip_exist.txt
├── ip_invalid.txt
├── log.txt
└── cors_detected.txt (new in v1.4+)
<status_code>.txt: IPs/URLs returning that status code.ip_exist.txt: Valid, reachable IPs/URLs.ip_invalid.txt: Failed or unreachable IPs/URLs.log.txt: Full detailed log of scanning activities.cors_detected.txt: IPs/URLs where CORS headers were found (Access-Control-Allow-Origin).
HyperScanner runs seamlessly on:
- 🪟 Windows
- 🐧 Linux
- 🍎 macOS
No additional setup needed — just Go installed.
We are building a beautiful, lightweight GUI version using Wails.
Stay tuned for an enhanced desktop experience with all HyperScanner features!
We welcome contributions! Here's how you can help:
- Fork the repository.
- Create a new branch (
feature/your-feature-name). - Commit your changes with clear messages.
- Open a Pull Request (PR) explaining your changes.
Let's make HyperScanner even better together! 🌟
This project is licensed under the MIT License — see the LICENSE file for details.
For support, feedback, or feature requests:
- GitHub: nxneeraj/hxscanner
- Email: neerajsahnx@gmail.com
- 🎯 Add terminal icons and detailed status code categories.
- 🖥️ Complete and release the GUI version.
- ⚡ Optimize performance for extremely large input lists.
- 🌍 Add proxy and multi-threaded support.
Build faster. Test smarter. Hack ethically.
With 💥 from Team HyperGod-X 👾
Keep Moving Forward