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

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

Manual download:

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

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

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for nibble_cli-0.8.3.tar.gz
Algorithm Hash digest
SHA256 0bc81760b15151ec2f3e74d54a779d8307be1dcf6826da520173f0f3f8c8cb62
MD5 ab41da465b67bb62a6d8fe8015e52621
BLAKE2b-256 5feacd50e6930ddf668b22dd53302fd2c5af47f75a52c401ba511fd7cbd1d426

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: nibble_cli-0.8.3-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.12

File hashes

Hashes for nibble_cli-0.8.3-py3-none-any.whl
Algorithm Hash digest
SHA256 0300c66315e5cb6b88a39140bc071a2a28ef0698bd444b21996c9f32cc1b3075
MD5 571110a1f37f9630367423b36e9affa1
BLAKE2b-256 cfd96be4c6a8ba17140987a19f1f13fc7e552367b468ef1ddc44747257fb6e94

See more details on using hashes here.

Provenance

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