https://github.com/backendsystems/nibble

easy to use network scanner
https://github.com/backendsystems/nibble

bubbletea cli devops go golang ip-scanner lan-discovery network-scanner networking nmap-alternative port-scanner sysadmin tui

Last synced: 4 days ago
JSON representation

easy to use network scanner

• Host: GitHub
• URL: https://github.com/backendsystems/nibble
• Owner: backendsystems
• License: mit
• Created: 2024-01-18T16:22:42.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2026-03-30T12:48:09.000Z (6 days ago)
• Last Synced: 2026-03-30T14:38:10.035Z (6 days ago)
• Topics: bubbletea, cli, devops, go, golang, ip-scanner, lan-discovery, network-scanner, networking, nmap-alternative, port-scanner, sysadmin, tui
• Language: Go
• Homepage:
• Size: 8.07 MB
• Stars: 124
• Watchers: 3
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: history.gif
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![GitHub Stars](https://img.shields.io/github/stars/backendsystems/nibble?style=social)](https://github.com/backendsystems/nibble)

[![PPA](https://img.shields.io/badge/Ubuntu-PPA-E95420?logo=ubuntu&logoColor=white)](#install-apt)

[![COPR](https://img.shields.io/badge/Fedora-COPR-51A2DA?logo=fedora&logoColor=white)](#install-dnf)

[![AUR](https://img.shields.io/aur/version/nibble-bin)](#install-aur)

[![brew](https://img.shields.io/badge/brew-tap-FBB040)](#install-brew)

[![winget](https://img.shields.io/badge/winget-package-0078D4?logo=windows&logoColor=white)](#install-winget)

[![npm](https://img.shields.io/npm/v/@backendsystems/nibble)](#install-npm)

[![PyPI](https://img.shields.io/pypi/v/nibble-cli)](#install-pip)

[![Go Report Card](https://goreportcard.com/badge/github.com/backendsystems/nibble)](https://goreportcard.com/report/github.com/backendsystems/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](demo.gif "Made with Bubble Tea VHS")

- 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](#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](history.gif "Made with Bubble Tea VHS")

## 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](click.gif "Clickable interface with mouse support")

## Installation



 go (https://go.dev/):

```bash

go install github.com/backendsystems/nibble@latest

```



 apt (Ubuntu, Mint, Pop!_OS, Zorin, Elementary, KDE Neon):

```bash

sudo add-apt-repository ppa:backendsystems/ppa

sudo apt install nibble

```



 dnf (Fedora, RHEL, CentOS Stream):

```bash

sudo dnf copr enable @backendsystems/nibble

sudo dnf install nibble

```



 aur (Arch Linux):

```bash

yay -S nibble-bin

```



 brew (macOS):

```bash

brew install backendsystems/tap/nibble

```



🪟 winget (Windows):

```bash

winget install backendsystems.nibble

```



 pip:

```bash

pipx install nibble-cli

```



 npm:

```bash

npm install -g @backendsystems/nibble

```

or run without install

```bash

npx @backendsystems/nibble

```

#### Manual download:

Pre-built binaries for Linux, macOS and Windows (amd64/arm64) are available on the [Releases](https://github.com/backendsystems/nibble/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](internal/parameters/example_input.txt))  

`-p` custom ports (e.g. `22,80,8000-8100` or `-` for all)  

`-o` write output to file instead of stdout ([example_output](internal/parameters/example_output.json))

```bash

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](https://github.com/charmbracelet/bubbletea)

## License

This project is MIT licensed. See the [LICENSE](LICENSE) file for details.

Note: The "nibble" name and branding assets are excluded from this license, see the separate [LICENSE](assets/LICENSE) for branding terms.