---
sidebar_position: 4
title: airtop
---

# airtop

> htop for the airwaves. A live 802.11 (Wi-Fi) RF dashboard in your terminal.

`airtop` turns the Wi-Fi traffic around you into a live terminal dashboard — a frequency spectrum of nearby access points, per-station signal traces, a frame-type activity feed, an RSSI histogram, and a rolling list of discovered networks. No monitor mode, no raw sockets. It attaches eBPF programs to `mac80211`/`cfg80211` and reads frames as they flow through the kernel's Wi-Fi stack, so it runs on your normal connected interface without dropping your link.

![airtop demo](/img/examples/airtop.gif)

## Running

```sh
yeet run github:yeet-src/airtop
```

For a shareable screenshot, anonymize SSIDs and MACs:

```sh
yeet run github:yeet-src/airtop -- --anonymize
```

To surface neighboring networks, trigger a scan first:

```sh
nmcli dev wifi rescan   # or: iw dev <iface> scan
```

## Source

[`yeet-src/airtop`](https://github.com/yeet-src/airtop) on GitHub.
