🔎 NetPeek

A modern libadwaita-based network scanner for GNOME that helps you discover devices on your local network.

📖 Table Of Contents

• 📷 Screenshots
• ⭐ Features
• 🔧 Installation
• 🙌 Help translate!
• 🔨 Local Development
• 👨🏻‍💻 Requirements
• ❓ Support

📷 Screenshots

⭐ Features

• 🔍 Fast Network Scanning - Discover active devices on your network
• 🎯 Port Scanning - Shows open ports on discovered devices
• 🖥️ Service Detection - Automatically identifies common services (SMB, Cockpit, MySQL, PostgreSQL, Plex, Home Assistant, and more)
• 🔬 Deep Scan Mode - Attempts OS detection & service version identification.
• 📇 Custom Names & History - Rename devices, browse and reload previous scans
• 🌗 Dark Mode - Follow system, or force light/dark
• ↕️ Sortable Results - Sort by known status, IP, hostname, custom name, ports, services, or OS
• 📱 Modern UI - Built with GTK4 and Libadwaita
• ⚡ Multi-threaded - Fast concurrent scanning with a configurable thread count
• 🔧 Flexible Input - Supports CIDR notation, IP ranges, and single IPs
• 🤖 Automatic IP Detection - Instantly finds your local IP range
• 📤 CSV Export - Export scan results for use elsewhere

🔧 Installation

👍 Flathub (Recommended)

Or install via the command line:

flatpak install flathub io.github.zingytomato.netpeek

👨🏻‍🔧 Unofficial Community Packages

Fedora COPR: https://copr.fedorainfracloud.org/coprs/infiniti151/flatpak-apps/package/netpeek/

🙌 Help translate!

Translations to your native language are very much appreciated.

Translate on Weblate

🔨 Local Development

GNOME Builder

GNOME Builder is the environment used for developing this application. It can use Flatpak manifests to create a consistent building and running environment cross-distro. Thus, it is highly recommended you use it.

1. Download GNOME Builder.
2. In Builder, click the "Clone Repository" button at the bottom, using https://github.com/zingytomato/netpeek.git as the URL.
3. Click the build button at the top once the project is loaded.

Supported Formats

• CIDR: 192.168.1.0/24, 10.0.0.0/16
• Range: 192.168.1.1-254, 10.0.0.1-50
• Single IP: 192.168.1.1

👨🏻‍💻 Requirements

• Python 3 with PyGObject (GTK4 bindings)
• python-nmap — nmap library for network scanning
• GTK4 and libadwaita (>= 1.6)
• nmap

📙 License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.

❓ Support

If you encounter any issues or have feature requests, please open an issue.