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.1.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.1-py3-none-any.whl (7.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: nibble_cli-0.8.1.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.1.tar.gz
Algorithm Hash digest
SHA256 255c2ca0632ae6005140e120287a55f0ef9e474ebef9eb6100d722babe70e84e
MD5 0946e1d93b81f1532048606a3173240f
BLAKE2b-256 7fec2bc84e623d6be4af63ef6fb3d4b36032b0cff098515062f9a6f54f9e087c

See more details on using hashes here.

Provenance

The following attestation bundles were made for nibble_cli-0.8.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: nibble_cli-0.8.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 9f186724f33208b2c1828d88da042857be7db3dcf95f89f942ea8ee025936eeb
MD5 26580fe2571c9d73aace9c9ca83abb81
BLAKE2b-256 e04e81545a917ee553e2cab40b39e864d661406865b22edeb810988bf2c5a26b

See more details on using hashes here.

Provenance

The following attestation bundles were made for nibble_cli-0.8.1-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