Repository navigation
Tutorial DVB T2 TV with a HackRF
adswill edited this page Oct 16, 2026
·
1 revision
Digital TV in a few clicks, plus how to fix a picture that breaks up.
- OnAir and a HackRF One or Pro (see HackRF); on Windows the WinUSB driver.
- A TV antenna with a clear view toward the transmitter. Height matters more than anything else.
- To know that your country uses DVB-T2 (Europe, Middle East, Africa, Asia, Australia). DVB-T, the older standard, uses the same screen: the DVB standard is detected automatically.
- Plug in the HackRF and the antenna and start OnAir. If the setup wizard asks, give your country: it picks the right TV standard.
- In the mode list choose DVB (group TV).
- Open the Scan tab and run the channel scanner. It finds channels automatically. (You can also type the frequency of a channel you know.)
- Press Start on the frequency you chose. A TV channel needs roughly one million samples per second per MHz of channel width, so an 8 MHz channel needs a radio that samples a little above 8 Msps; the HackRF reaches 20 Msps and OnAir tells you next to the source if the rate is too low.
- Wait for the receiver to lock. The status shows the signal-to-noise ratio and the error counts, and a single quality score.
- Open the TV tab, click a service and watch. The player has sound, subtitles, teletext, a programme Guide and multiple audio tracks.
- Use Auto-tune for the gain, or Optimise gain: it sweeps the radio's whole gain range, measures the SNR and keeps the lowest gain within 0.5 dB of the best one that does not overload the converter. Undo gain goes back.
- Watch the echo (multipath) detector in the status: echoes from buildings are the usual cause of a broken picture. Move the antenna and watch the quality score.
- The Antenna tab has a direction finder that helps you aim the antenna.
- OnAir repairs short signal dropouts automatically so a weak signal stays watchable.
- On the Stream tab record the stream to a file or send it out over UDP. Release 0.2.6 adds recording a service from the TV tab, with pause and a live buffer.
- The built-in network tuner streams your channels to VLC, phones, Plex or Jellyfin over your home network, as a plain stream or as HLS for browsers and phones.
- On a Mac you can cast the playing service to an Apple TV or AirPlay TV.
Limits. Encrypted (scrambled) services cannot be decoded. T2-Lite is decoded like any other T2 signal and was checked on simulated signals, not yet on a real T2-Lite broadcast.
Related: DVB-T2 and DVB-T, Troubleshooting.
Getting started
Using OnAir
Tools and guides (0.2.7)
- Band survey
- Message database
- Watchlists
- TV recorder
- Time machine
- Pass scheduler
- Plugin SDK
- Headless server
- All guides
Radios
Modes by group
- TV
- Broadcast radio
- Aviation
- Maritime
- Satellite & navigation
- Two-way radio
- Cellular & rail
- Pagers
- IoT & sensors
- Weather & science
- Amateur: digital
- Amateur: voice & packet
- HF utility
- General & tools
Tutorials
- DVB-T2 TV with a HackRF
- FM radio with RDS
- Aircraft with ADS-B and the map
- Ships with AIS
- DAB+ digital radio
- Weather satellite images
- HF digital: FT8 and WSPR
- Digital voice: DMR, D-STAR, P25
- Pagers: POCSAG and FLEX
- Time stations and the clock
- Record IQ, then the Signal workbench
- The signal sample library
- Control a rig with Hamlib
- Two receivers and the multi-decoder
Reference
Help
Legal and privacy
More