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

Uploaded Python 3

File details

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

File metadata

  • Download URL: nibble_cli-0.8.0.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.0.tar.gz
Algorithm Hash digest
SHA256 a404eb3d6260a466b567adef2a89fb943132271dd2f7d05fa1d026010bd9a566
MD5 7715992c4def157eb6be336ba32ed785
BLAKE2b-256 42842e69dbb0abd6d98a7b6d145c731a21eb6d6eee168c44b12716b0826b9737

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: nibble_cli-0.8.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 518f4f69bbe948f70c3d54854063a5f065533bc135cf9959daa7550501f12024
MD5 1f22947442d7fc80fc2fd1da188bb03f
BLAKE2b-256 839764c84c016144d3c8ae704e782c240e604c859b2670068d2ad2ad462bd134

See more details on using hashes here.

Provenance

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