"Terminal Network Scanner"

This project is a command-line tool written in Python 3 that scans your local network to discover active hosts. It presents the findings in an interactive Terminal User Interface (TUI) built using the curses library, making it easy to navigate and explore network devices directly from your terminal.

It was primarily developed with Linux systems like Raspberry Pi OS in mind, leveraging common Linux networking tools, but should be adaptable to other Unix-like systems. It's a handy utility for quickly seeing what's connected to your network without needing a graphical interface.

networkscanner

Key Features

Interactive TUI: Navigate scan results, view host details, and trigger actions using keyboard shortcuts within the terminal.
Automatic Network Detection: Attempts to automatically find your local IP, gateway, and network range upon startup.
Multi-threaded Scanning: Uses threading for non-blocking scans, keeping the UI responsive.
Host Discovery & Details: Uses ping and ARP/neighbor methods to find live hosts and retrieves IP Address, resolved Hostname (if available), and MAC Address.
Detailed Host View: Offers more insights for a selected host, including live ping statistics and a quick scan for common open ports (like HTTP, SSH, FTP, etc.).
External Tool Integration: Provides shortcuts to easily launch nmap (for detailed port/service scanning) or traceroute against a selected host (requires these external tools to be installed and potentially sudo).

Technology Stack

Core: Python 3
Terminal UI: curses standard library module
Networking & System: socket, subprocess, ipaddress, re, os standard libraries
Concurrency: threading, queue standard libraries
External Dependencies (Optional but Recommended): ping, ip, arp, arp-scan, nmap, traceroute (common Linux command-line tools)

Source Code

The complete source code, along with more detailed setup and usage instructions, is available on GitHub. Feel free to check it out, use it, or contribute!

➡️ View on GitHub

emphyrio.io