NetPeek

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

📖 Table of Contents

• 📷 Screenshots
• ⭐ Features
• 🔧 Installation
• 🔨 Local Development
• 🙌 Help Translate
• ❓ Support
• 📙 License

📷 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 and service version identification
• Custom Names and History -- Rename devices, browse and reload previous scans
• Scan Info Dialog -- View detailed scan metadata for current and previous scans
• Dark Mode -- Follow system theme, or force light/dark
• Sortable Results -- Sort by known status, IP, hostname, custom name, ports, services, or OS
• Searchable Results -- Search and filter devices on scan pages
• Modern UI -- Built with GTK4 and libadwaita
• Multi-threaded -- Fast concurrent scanning with a configurable thread count
• Flexible Input -- Supports CIDR notation (192.168.1.0/24), IP ranges (192.168.1.1-254), 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/

🔨 Building from Source

Dependencies:

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

🔨 Local Development

GNOME Builder is the recommended development environment. It uses Flatpak manifests to provide a consistent build environment across distributions.

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.

🙌 Help Translate

Translations to your native language are very much appreciated.

Translate on Weblate

❓ Support

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

📙 License

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