Terminal Network Scanner

🔍 Terminal Network Scanner

Ever wondered what devices are lurking on your local network? Whether you're a curious Raspberry Pi tinkerer or a seasoned sysadmin, Terminal Network Scanner gives you a sleek, terminal-based interface to explore your network like a pro.

This command-line tool is written in Python 3 and built for Unix-like systems (especially Linux). It scans your local network to discover active hosts and presents the results in an interactive Terminal User Interface (TUI) built with Python's curses library.

No GUI? No problem. This project was born for the terminal.

🚀 Key Features

• 🎛 Interactive TUI: Scan results are displayed in a terminal UI with keyboard navigation and shortcuts—no need to scroll through logs or plain-text lists.
• 🌐 Automatic Network Detection: On startup, the tool automatically detects your local IP, gateway, and subnet.
• ⚡️ Multi-threaded Scanning: Fast and responsive, thanks to threading—scan large networks without freezing the interface.
• 📡 Host Discovery & Details: Finds live hosts using ping and ARP/neigh techniques. Displays IP address, MAC address, and resolved hostnames (when available).
• 🔍 Detailed Host View: Select a host to get real-time ping stats and quick scans for common ports (like HTTP, SSH, FTP).
• 🔗 External Tool Integration: Easily launch nmap or traceroute against a host directly from the UI (requires these tools and possibly sudo access).

🛠 Tech Stack

• Language: Python 3
• UI: curses (standard Python module)
• Networking: socket, ipaddress, subprocess, os, re
• Concurrency: threading, queue

🔧 Optional External Dependencies

To unlock the full power of the scanner, the following command-line tools are recommended:

• ping
• ip
• arp or arp-scan
• nmap
• traceroute

All are commonly available on most Linux distros and can be installed via package managers like apt.

💻 Perfect for Raspberry Pi & Linux Terminals

This tool was designed with Linux systems in mind—especially headless setups like Raspberry Pi OS. It gives you full network visibility with zero graphical overhead.

📂 Source Code

The complete source code, setup instructions, and more are available on GitHub.

➡️ View on GitHub

Feel free to explore, fork, contribute, or open issues!

✨ Final Thoughts

Terminal Network Scanner is more than just a network scanner—it's a terminal-native dashboard for your LAN. Whether you're doing home network audits or building scripts around it, it’s a fast and flexible way to keep tabs on connected devices.

Give it a spin in your terminal and see what’s online!

Made with Python, curiosity, and a love for clean terminal tools.