Skip to content

backendsystems/nibble

Repository files navigation

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