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 it scans your local subnet.
Lists hosts, hardware manufacturer, open ports and their services.

Clickable interface with mouse support

  • ⚡ Lightning fast, scans using lightweight threads
  • 🔒 Safe, does not need admin access or special privileges
  • 🥷 Stealthy, emits no network signals before a scan is started
  • Clickable interface, use your mouse to navigate and scan 🖱️
    • or navigate with ↑/↓/←/→, w/s/a/d or h/j/k/l
    • context aware help screens, hotkey: ?
  • Docker networks and WSL support 📦
    • instant docker network scans when a docker socket is detected
    • can scan windows interfaces from inside wsl
  • Shows detected hardware makers: 📙
    • Raspberry Pi, Ubiquiti, Apple and 40,000 other vendor ids
    • Reads service banners on open ports (for example, ssh or nginx)
  • Colors matches your terminal theme automatically 🌈
  • 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
  • History mode for past scans lookup 📜
  • 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

Easy Installation

Platform Manager Command
Ubuntu
or Mint, Pop!_OS, Zorin, ...
apt sudo add-apt-repository ppa:backendsystems/ppa
sudo apt install nibble
Fedora
or RHEL, CentOS Stream, ...
dnf sudo dnf copr enable @backendsystems/nibble
sudo dnf install nibble
Arch Linux aur yay -S nibble-bin
macOS brew brew install backendsystems/tap/nibble
🪟 Windows winget winget install backendsystems.nibble
Any npm npm install -g @backendsystems/nibble
or npx @backendsystems/nibble
Any pip pipx install nibble-cli
Any go go install github.com/backendsystems/nibble@latest

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

Usage

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

Headless Mode

Run scans without the TUI. Outputs JSON. Activated by the -i input flag.
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.

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.

Built with Bubble Tea

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-1.0.0.tar.gz (7.0 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-1.0.0-py3-none-any.whl (7.9 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for nibble_cli-1.0.0.tar.gz
Algorithm Hash digest
SHA256 36a77565c87a1cf34b4329d77d5cc40b3b27c0027945776d3c7246789fc381dd
MD5 7105e7e21503716bbd201d7ac537b79c
BLAKE2b-256 5cf4e08a6cb8c3528f3838361e25074d56222ff049cad1479ddd60c0c002641c

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: nibble_cli-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 7.9 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-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9cb0a4ea64e50f8f3ae0b81972bc69900a4fac67d6cbe90231347a4e2a37a754
MD5 be7e23412738b12ccc563bbeb0e03467
BLAKE2b-256 653a4bf2d923f9d575f510ecc225abdd941b34eb30d9aa021372236bedcaa1ac

See more details on using hashes here.

Provenance

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