Netoster: Your Network Detective
A powerful (maybe?), cross-platform network scanner with device identification and speculation capabilities. Built in Python with both GUI and CLI interfaces, Netoster discovers devices on your network and intelligently identifies their types, vendors, and running services. Its my first github project.
- ๐ Dual Scanning Modes: ARP scanning (admin) and Ping scanning (standard)
- ๐ฏ Device Identification: Intelligent speculation of device types (smartphones, computers, IoT devices, etc.)
- ๐ท๏ธ Vendor Detection: MAC address-based vendor identification
- ๐ Hostname Resolution: Automatic hostname lookup for discovered devices
- ๐ Port Scanning: Quick scan of common ports and services
- ๐ฅ๏ธ Cross-Platform: Works on Windows, macOS, and Linux
- ๐ฑ Interactive GUI: User-friendly interface with detailed device information
- โก Fast & Efficient: Multi-threaded scanning for quick results
- ๐ Permission Aware: Graceful fallback when admin privileges unavailable
python3 --version
pip install scapy tkinter
- Clone or download the Netoster script
- Run with full privileges for best results:
Linux/macOS(not tested on macOS tbh): sudo python3 Netoster.py
at the place where you downloaded the code
Windows: Right-click Command Prompt โ "Run as Administrator"
python Netoster.py
- Launch Netoster
- Enter your network range (e.g.,
192.168.1.1/24) - Click ๐ Scan Network
- View discovered devices in the table
- Click on any device for detailed information
info) Finding Your Network Range:
Linux/macOS: ip route show default
Windows: ipconfig
Common network ranges:
192.168.1.1/24192.168.0.1/24192.168.219.1/2410.0.0.1/24
| Information | Description |
|---|---|
| IP Address | Device network address |
| MAC Address | Hardware identifier (ARP mode only) |
| Vendor | Device manufacturer |
| Device Type | Intelligent speculation (iPhone, Router, Printer, etc.) |
| Hostname | Network name resolution |
| Open Ports | Running services and protocols |
- โ ARP scanning with MAC addresses
- โ Complete vendor identification
- โ Full device speculation
- โ Comprehensive network mapping
- โ Ping-based device discovery
- โ Hostname resolution
- โ Port scanning
- โ No MAC addresses or vendor info
Linux/macOS: sudo python3 Netoster.py
Windows: Run Command Prompt as Administrator
export DISPLAY=:0.0 sudo -E python3 Netoster.py
- โ Check you're scanning the correct network range
- โ Ensure you're connected to WiFi/network
- โ Try running with administrator privileges
Install missing dependencies
pip install scapy pip install tk # If tkinter missing
- ๐ฑ Mobile Devices: iPhones, Android phones, tablets
- ๐ป Computers: Laptops, desktops, MacBooks
- ๐ Network Equipment: Routers, switches, access points
- ๐จ๏ธ Printers: HP, Canon, network printers
- ๐บ Media Devices: Smart TVs, Roku, Chromecast, Apple TV
- ๐ IoT Devices: Smart home devices, Raspberry Pi
- ๐ฎ Gaming: Consoles, gaming devices
- Python: 3.7 or higher
- Scapy: For network packet manipulation
- Tkinter: For GUI (usually included with Python)
- Threading: For concurrent operations
- Socket: For network operations
Netoster is designed for:
- โ Your own networks
- โ Authorized network administration
- โ Security auditing with permission
- โ Educational purposes
Please use responsibly and only on networks you own or have explicit permission to scan.
We welcome contributions! Areas for improvement:
- ๐ง Enhanced device fingerprinting
- ๐ Additional vendor databases
- ๐ Export functionality (CSV, JSON)
- ๐จ UI/UX improvements
- ๐ Bug fixes and optimizations
This project is open source and available under the GNU GENERAL PUBLIC LICENSE 3.0.
- Inspired by Fing network discovery tool
- Built with Scapy for network operations
- Python and Tkinter for cross-platform compatibility
- I am Korean I added this just for fun
Having issues? Check the troubleshooting section above or create an issue with:
- Your operating system
- Python version (
python3 --version) - Error message (if any)
- Network configuration
Netoster - Solving your network mysteries, one device at a time! ๐ต๏ธโโ๏ธโจ