explaingit

yeet-src/airtop

Analysis updated 2026-05-18

31JavaScriptAudience · ops devopsComplexity · 3/5Setup · moderate

TLDR

A terminal dashboard for Linux, like htop but for Wi-Fi, showing nearby access points and signal activity in real time.

Mindmap

mindmap
  root((airtop))
    What it does
      Real time Wi-Fi dashboard
      Reads frames via eBPF
      No monitor mode needed
    Tech stack
      Linux eBPF
      JavaScript
      Terminal UI
    Use cases
      Diagnose slow Wi-Fi
      Pick a clean channel
      Spot deauth attacks
    Audience
      Developers
      Network administrators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Diagnose why a video call is stuttering by checking for Wi-Fi channel congestion.

USE CASE 2

Pick a clean, uncrowded Wi-Fi channel before an important call or presentation.

USE CASE 3

Check whether a nearby access point is actually broadcasting before troubleshooting a connection.

USE CASE 4

Watch the frame-type heatmap to spot unexpected deauthentication attacks on a network.

What is it built with?

JavaScripteBPFLinux

How does it compare?

yeet-src/airtopforgetmeai/freedeepseekapimattpocock/boilersuit
Stars313131
LanguageJavaScriptJavaScriptJavaScript
Last pushed2018-10-26
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audienceops devopsgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 5min

Requires Linux with BTF kernel support and the yeet runtime, installed with one curl command.

License terms are not stated in the description, check the repository directly before using or redistributing this code.

In plain English

airtop is a terminal dashboard for Linux that shows you what is happening with the Wi-Fi radio signals around you, in real time. Think of it like htop, the system process monitor, but instead of CPU and memory it displays nearby Wi-Fi access points, their signal strengths, and the types of wireless traffic the kernel is picking up. The tool reads 802.11 Wi-Fi frames directly from the Linux kernel using eBPF, a technology that lets programs attach to kernel functions without modifying the kernel itself. This means airtop works on your normal, connected Wi-Fi interface without switching into monitor mode or dropping your internet connection. No extra hardware or special card configuration is needed. When you run it, you get several live panels in the terminal. A frequency spectrum shows every access point plotted at its actual channel frequency, which reveals when multiple routers are competing on the same channel, the most common reason for slow Wi-Fi. A signal chart tracks each nearby device over time. A frame-type heatmap shows the mix of management, control, and data packets, and it highlights deauthentication floods instantly, which is the signature of a wireless deauth attack or a misbehaving router. An access point list ranks nearby networks by signal strength, and a signal histogram shows the overall shape of the RF environment around you. The practical uses are straightforward: figure out why a video call is stuttering due to channel congestion, check whether an access point is actually broadcasting before troubleshooting a connection, pick a clean channel before a presentation, or spot unexpected deauth traffic on a network. The tool counts frames rather than bytes, and it only sees the channel your radio is currently on, so it is not a full packet capture suite. For deep forensics you would still want a dedicated monitor-mode tool. Running airtop requires Linux with BTF kernel support (which ships by default on Ubuntu, Fedora, Arch, and Debian 12+), a standard Wi-Fi card, and the yeet runtime that handles the privileged kernel attachment. One curl command installs the runtime and two commands start the dashboard.

Copy-paste prompts

Prompt 1
Show me how to install and run airtop on my Linux machine.
Prompt 2
Explain what airtop's frequency spectrum panel is telling me about channel congestion.
Prompt 3
Help me use airtop to figure out why my Wi-Fi call keeps stuttering.
Prompt 4
Walk me through what a deauthentication flood looks like in airtop's frame-type heatmap.

Frequently asked questions

What is airtop?

A terminal dashboard for Linux, like htop but for Wi-Fi, showing nearby access points and signal activity in real time.

What language is airtop written in?

Mainly JavaScript. The stack also includes JavaScript, eBPF, Linux.

What license does airtop use?

License terms are not stated in the description, check the repository directly before using or redistributing this code.

How hard is airtop to set up?

Setup difficulty is rated moderate, with roughly 5min to a first successful run.

Who is airtop for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.