Skip to content

Jason-Yeom/Netoster

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

13 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Netoster ๐Ÿ•ต๏ธโ€โ™‚๏ธ

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.

โœจ Features

  • ๐Ÿ” 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

๐Ÿš€ Installation

Prerequisites

Install Python 3.7 or higher

python3 --version

Install required packages

pip install scapy tkinter

Quick Start

  1. Clone or download the Netoster script
  2. 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

๐ŸŽฎ Usage

GUI Mode (Default)

  1. Launch Netoster
  2. Enter your network range (e.g., 192.168.1.1/24)
  3. Click ๐Ÿ” Scan Network
  4. View discovered devices in the table
  5. 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/24
  • 192.168.0.1/24
  • 192.168.219.1/24
  • 10.0.0.1/24

๐Ÿ“Š What Netoster Discovers

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

๐Ÿ”ง Scanning Modes

Full Mode (Administrator/sudo)

  • โœ… ARP scanning with MAC addresses
  • โœ… Complete vendor identification
  • โœ… Full device speculation
  • โœ… Comprehensive network mapping

Limited Mode (Standard user)

  • โœ… Ping-based device discovery
  • โœ… Hostname resolution
  • โœ… Port scanning
  • โŒ No MAC addresses or vendor info

๐Ÿ› ๏ธ Troubleshooting

"Permission denied" errors

Linux/macOS: sudo python3 Netoster.py

Windows: Run Command Prompt as Administrator

GUI won't start (Linux)

export DISPLAY=:0.0 sudo -E python3 Netoster.py

No devices found

  • โœ… Check you're scanning the correct network range
  • โœ… Ensure you're connected to WiFi/network
  • โœ… Try running with administrator privileges

Import errors

Install missing dependencies

pip install scapy pip install tk # If tkinter missing

๐ŸŽฏ Device Types Netoster Can Identify

  • ๐Ÿ“ฑ 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

๐Ÿ“‹ Requirements

  • 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

๐Ÿ”’ Security & Ethics

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.

๐Ÿค Contributing

We welcome contributions! Areas for improvement:

  • ๐Ÿ”ง Enhanced device fingerprinting
  • ๐ŸŒ Additional vendor databases
  • ๐Ÿ“Š Export functionality (CSV, JSON)
  • ๐ŸŽจ UI/UX improvements
  • ๐Ÿ› Bug fixes and optimizations

๐Ÿ“„ License

This project is open source and available under the GNU GENERAL PUBLIC LICENSE 3.0.

๐Ÿ™ Acknowledgments

  • 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

๐Ÿ“ž Support

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! ๐Ÿ•ต๏ธโ€โ™‚๏ธโœจ

About

Netoster: Solving Your Network Mysteries

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages