Skip to main content

Fast local network scanner with hardware identification and a terminal UI

Project description

GitHub Stars PPA COPR AUR brew winget npm PyPI Go Report Card

Nibble

Nibble is a CLI tool for local network scanning that focuses on speed and ease of use.

Select a network interface, and Nibble scans your local subnet. Lists hosts, hardware manufacturer, open ports and their services.

Nibble demo

  • Lightning fast scans using lightweight threads
  • Stealthy, emits no network signals before a scan is started
  • Colors uses your terminal theme colors
  • Skips loopback and irrelevant adapters
  • Defaults to SSH, Telnet, HTTP, HTTPS, SMB, RDP, and more
  • Can be set to a list of custom ports that are stored for future use
  • Target mode for targeted network scans
  • Reads service banners on open ports (for example, OpenSSH or nginx versions)
  • Looks up hardware vendors:
    • Raspberry Pi, Ubiquiti, Apple and 40,000 other vendor ids
  • Headless mode with JSON output for scripting and automation

History

See past scans, the found hosts and re-scan all hosts ports. hotkey: r
History remembers your position between sessions, so jump right back in to your last viewed scan.

Nibble history

Hotkeys

↑/↓/←/→, w/s/a/d, h/j/k/l: selection Enter: confirm p: select ports r: history t: target mode q: cancel Ctrl+C: quit ?: help

Mouse

Full mouse support. Click to select, click again to confirm. Scroll to navigate lists. Hold Shift and drag to select text.

Nibble click interface

Installation

Manual download:

Pre-built binaries for Linux, macOS and Windows (amd64/arm64) are available on the Releases page.

Package managers:

go (https://go.dev/):

go install github.com/backendsystems/nibble@latest

apt (Ubuntu, Mint, Pop!_OS, Zorin, Elementary, KDE Neon):

sudo add-apt-repository ppa:backendsystems/ppa
sudo apt install nibble

dnf (Fedora, RHEL, CentOS Stream):

sudo dnf copr enable @backendsystems/nibble
sudo dnf install nibble

aur (Arch Linux):

yay -S nibble-bin

brew (macOS):

brew install backendsystems/tap/nibble

🪟 winget (Windows):

winget install backendsystems.nibble

pip:

pipx install nibble-cli

npm:

npm install -g @backendsystems/nibble

or run without install

npx @backendsystems/nibble

Usage

Run the CLI with nibble, select a network interface.
Interface icons: 🔌Ethernet, 📶Wi-Fi, 📦Container, 🔒VPN.

Headless Mode

Run scans without the TUI. Outputs JSON.
Headless scans are not saved in history.

-i scan target(s), comma-separated or a file (example_input)
-p custom ports (e.g. 22,80,8000-8100 or - for all)
-o write output to file instead of stdout (example_output)

nibble -i 192.168.0.0/24
nibble -i 192.168.1.223,10.0.0.12/32 -p - -o results.json
nibble -i targets.txt -p 22,80,443,8000-8100

Exit codes: 0 success, 1 error, 2 invalid usage.

Built with Bubble Tea

License

This project is MIT licensed. See the LICENSE file for details.

Note: The "nibble" name and branding assets are excluded from this license, see the separate LICENSE for branding terms.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nibble_cli-0.8.2.tar.gz (6.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nibble_cli-0.8.2-py3-none-any.whl (7.8 kB view details)

Uploaded Python 3

File details

Details for the file nibble_cli-0.8.2.tar.gz.

File metadata

  • Download URL: nibble_cli-0.8.2.tar.gz
  • Upload date:
  • Size: 6.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for nibble_cli-0.8.2.tar.gz
Algorithm Hash digest
SHA256 7c9db69f1e3b8487c8cfcd06d11a8a9347173ecacc907da001f604c200116a08
MD5 91904a5f4bf32cac5738a0681e27ec0c
BLAKE2b-256 7e6d5467943a9a7b4bfae82fc94b4ed1e0d7fd5362a8e1629271387b35127c93

See more details on using hashes here.

Provenance

The following attestation bundles were made for nibble_cli-0.8.2.tar.gz:

Publisher: pypi-publish.yml on backendsystems/nibble

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file nibble_cli-0.8.2-py3-none-any.whl.

File metadata

  • Download URL: nibble_cli-0.8.2-py3-none-any.whl
  • Upload date:
  • Size: 7.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for nibble_cli-0.8.2-py3-none-any.whl
Algorithm Hash digest
SHA256 27991b156856ef5f839009c6080d8814f301666040d3c3fd0802832ee30af3c3
MD5 7180c77864d5f228d2b80e7deb5a0706
BLAKE2b-256 46cc594fca03f43062b3a43bd73892b29e228f8ad28d89409ec3b84977a70695

See more details on using hashes here.

Provenance

The following attestation bundles were made for nibble_cli-0.8.2-py3-none-any.whl:

Publisher: pypi-publish.yml on backendsystems/nibble

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page