homelab

Turn a $30 TV Tuner Stick Into a Live Plane Tracker (ADS-B)

🤖 Researched and drafted automatically from the official docs, and reviewed before publishing. Commands are taken from the source projects — but always sanity-check before running anything on your own hardware.

Most airliners and many smaller aircraft broadcast their position on 1090 MHz using ADS-B: a callsign, altitude, speed and position, several times a second. Flight-tracking apps show you that data, but it comes from other people’s receivers. With a cheap USB radio stick and a small Linux machine you can receive it yourself and see the aircraft in range of your antenna on a live map.

You only receive. Nothing transmits, so there is no licence to get. Receiving ADS-B is legal in most countries; if you are unsure, check your local rules.

What you need

  • A USB radio stick built on the RTL2832U chip. Two common choices:
    • A generic DVB-T TV tuner stick with an RTL2832U and R820T2 tuner. These work with the standard rtl-sdr drivers.
    • An RTL-SDR Blog V4, made for software-defined radio. It needs updated drivers (see Step 1).
  • An antenna. The small whip that ships with most sticks works to start. An antenna tuned for 1090 MHz, mounted high, adds the most range.
  • A Linux machine that uses apt: a Raspberry Pi running Raspberry Pi OS, or an old laptop with Debian or Ubuntu. The tar1090 installer assumes Raspbian, Debian or Ubuntu and does not work without apt.

How many aircraft you see depends on your antenna and its view of the sky. An antenna behind a window, low down, sees far fewer than one on a roof.

Step 1: Check the stick is detected

For a generic RTL2832U stick, install the standard tools and run the test:

sudo apt install rtl-sdr
rtl_test

If rtl_test finds your device and names the tuner, the hardware side is working. Stop it with Ctrl+C.

RTL-SDR Blog V4 owners: the V4’s circuitry changed, and the RTL-SDR Blog team says it needs their updated drivers; with the stock package it will not tune correctly. Follow the driver instructions on the RTL-SDR Blog V4 page before the next step. Their drivers also work with older and generic RTL-SDR sticks.

Step 2: Install a decoder

The decoder turns raw radio samples into aircraft messages. tar1090 sits on top of readsb or dump1090-fa, so you need one of them first. The tar1090 author maintains an installer for readsb; follow the Automatic installation for readsb page, which also explains how to set your receiver’s location.

Step 3: Install tar1090

tar1090 is the web interface: a map with every aircraft your receiver decodes, plus tracks, labels and filters. From its README:

sudo bash -c "$(wget -nv -O - https://github.com/wiedehopf/tar1090/raw/master/install.sh)"

Run the same command again later to update it.

Step 4: Open the map

On any device on your network, open:

http://<your-pi-ip>/tar1090

Each aircraft appears as an icon. Click one to see its callsign, altitude, speed and the data source. Add ?pTracks to the address to see the tracks your receiver has collected.

Getting more aircraft

  • Antenna height and view matter most. Move it up and away from walls and metal; a window facing open sky beats an inside wall.
  • A 1090 MHz antenna outperforms the stock whip.
  • A filtered, amplified stick like the FlightAware Pro Stick Plus helps when nearby signals (mobile, broadcast) swamp the band.

What you end up with

A small computer, a cheap stick and a live map of the aircraft in range of your roof, built from data you receive yourself.

Related guides

← All guides