Kodi Live TV From Your Aerial: PVR Setup the Legal Way With Tvheadend and HDHomeRun

November 12, 2026 Comments Off on Kodi Live TV From Your Aerial: PVR Setup the Legal Way With Tvheadend and HDHomeRun
Kodi My add-ons, PVR clients list showing HDHomeRun Client 21.0.2 and Tvheadend HTSP Client 21.2.6
My add-ons, PVR clients, with the official HDHomeRun Client and Tvheadend HTSP Client. Screenshot: official Kodi 21.2 with the default Estuary skin on my own test machine, October 2026 (menus match Kodi 21.3). Kodi is a trademark of the XBMC Foundation. HDHomeRun is a trademark of SiliconDust.
Contents hide
1 Why Kodi’s TV section is empty
2 Ingredient 1: a tuner that speaks Freeview
3 Ingredient 2: pick your backend
4 Recipe A: the HDHomeRun Client
5 Recipe B: the Tvheadend server
6 Installing the PVR client
7 Configure and enable the Tvheadend client
8 TV, Guide and recording
9 What about Kodi 22 Piers?
10 The recipe card
11 Best IPTV boxes to buy

Kodi has a TV button. You press it, full of hope, and Kodi tells you: “You did not set up PVR yet.” Thanks, Kodi. Very helpful.

Here is the good news. That button can give you proper live TV straight from the aerial on your roof, with a TV guide, pause, rewind and recording. All of it legal, all of it official, no dodgy anything. Welcome to Kodi Kitchen: today we bake live TV from three ingredients, and I will tell you exactly which shop sells each one.

Watch the video: Kodi Live TV From Your Aerial: PVR Setup the Legal Way (Tvheadend & HDHomeRun)

Why Kodi’s TV section is empty

Kodi has no TV tuner inside it. None. It is a very good waiter with no kitchen. The Kodi wiki lists the three things you need:

  1. A tuner, which plugs into your aerial cable.
  2. A backend, a small server that does the tuning (and, with the right one, the recording).
  3. A PVR client, an official Kodi add-on that connects Kodi to that backend.

PVR stands for personal video recorder. The best part: one backend serves the whole house, and every Kodi device that wants live TV just gets the client add-on.

Ingredient 1: a tuner that speaks Freeview

You have three choices: a card inside a computer, a USB tuner stick, or a network tuner that plugs into your router. Freeview HD in the UK uses DVB-T2, so whatever you buy must support it.

This is where people get caught out with HDHomeRun. SiliconDust’s own page names the HDHomeRun FLEX QUATRO (HDFX-4DT) as its current model for the UK, Europe, Australia and New Zealand, with DVB-T and DVB-T2 including Freeview HD. The same page says the HDFX-2US, HDFX-4US and HDFX-4K are made for the American ATSC standard and will not work in the UK. If you find an older unit, the rule of thumb is the letters at the end: the CONNECT DUO and CONNECT QUATRO DVB versions (HDHR5-2DT and HDHR5-4DT) also do DVB-T and DVB-T2, and SiliconDust’s shop sells them refurbished for the UK. Anything ending in US or 4K is the wrong plug for the wrong country.

Two more things before you spend money. The Kodi wiki advises against running network tuners over Wi-Fi, and an HDHomeRun connects by Ethernet anyway, so plan for a cable to your router. And in the UK you still need a TV Licence to watch or record programmes as they are broadcast, exactly like your normal telly. Kodi does not change that.

Ingredient 2: pick your backend

This is the choice that decides whether you get a recorder. The Kodi wiki also notes that no backend runs on Android, iOS or tvOS, so on those devices you only install the client and point it at a backend elsewhere on your network.

Recipe What you get in Kodi Records in Kodi?
A: HDHomeRun with the HDHomeRun Client Live TV and the TV guide No
B: Tvheadend (any supported tuner, including an HDHomeRun) with the Tvheadend HTSP Client Live TV, guide, recordings, timers, pause and rewind Yes

Recipe A: the HDHomeRun Client

The quick one. The HDHomeRun sits on your network and Kodi’s official HDHomeRun Client finds it for you. Before you touch Kodi, set the tuner up and scan your channels in SiliconDust’s own HDHomeRun app, because the Kodi wiki’s advice is to get live TV working in the backend first.

In the add-on settings you get a short list of switches: hide protected channels, enable debug logging, hide duplicate channels, mark new show and use HTTP discovery. For most homes the defaults are fine.

Kodi HDHomeRun Client add-on settings
The official HDHomeRun Client settings in Kodi. Screenshot: official Kodi 21.2 with the default Estuary skin on my own test machine, October 2026 (menus match Kodi 21.3). Kodi is a trademark of the XBMC Foundation. HDHomeRun is a trademark of SiliconDust.

Now the catch. The client is live TV and guide only. I checked the official source code on the Kodi PVR GitHub, for both the Omega (Kodi 21) and Piers (Kodi 22) branches: recordings and timers are switched off in the client. SiliconDust’s own app can record to a USB drive plugged into the HDHomeRun, but that DVR lives in SiliconDust’s app, not in Kodi’s Recordings menu. Want Kodi itself to be the recorder? That is Recipe B.

Recipe B: the Tvheadend server

The chef’s special. Tvheadend is an open source TV streaming server and video recorder for Linux, and the Kodi wiki lists it for Linux, macOS and the Raspberry Pi. Its documentation covers internal cards, USB tuners and network tuners, and the project’s own page lists HDHomeRun among its supported inputs. So you can keep that HDHomeRun and still get recordings.

On LibreELEC it is one install away rather than a separate project: Add-ons > Install from repository > LibreELEC Add-ons > Services > Tvheadend Server. On Debian or Ubuntu it comes as a normal package.

You set Tvheadend up in a web browser on port 9981 (for example 192.168.1.20:9981, using your server’s address). The setup wizard walks you through access control, your tuner and network, the predefined muxes for DVB-T2 and your local transmitter, the scan, and mapping services to channels. Make sure you can watch a channel in Tvheadend before you connect Kodi. Taste the sauce before you serve it.

Installing the PVR client

On Android, Windows and macOS go to Settings > Add-ons > Install from repository > PVR clients, pick HDHomeRun Client or Tvheadend HTSP Client and press Install. Both come from the official Kodi Add-on repository.

Linux is different, and my test machine runs Linux, so I hit this myself. The PVR clients come as system packages, such as kodi-pvr-hts and kodi-pvr-hdhomerun, so the PVR clients category does not even appear in the repository until you install them. On LibreELEC, CoreELEC and OSMC the PVR add-ons are already bundled. Either way you end up in Add-ons > My add-ons > PVR clients, where both sit waiting for their big moment.

Configure and enable the Tvheadend client

Open the Tvheadend HTSP Client, choose Configure and fill in the connection settings:

  • Name: anything you like. Mine is “Living room TV server”, because I am very creative.
  • Tvheadend hostname or IP address: the machine running Tvheadend. Mine runs on the same box, so 127.0.0.1. Yours is probably something like 192.168.1.20.
  • HTTP port 9981 and HTSP port 9982: leave the defaults unless you changed them in Tvheadend.
  • Username and password: only if you set them up in Tvheadend.
Kodi Tvheadend HTSP Client configuration with hostname 127.0.0.1, HTTP port 9981 and HTSP port 9982
Tvheadend HTSP Client connection settings pointing at my local test server. Screenshot: official Kodi 21.2 with the default Estuary skin on my own test machine, October 2026 (menus match Kodi 21.3). Kodi is a trademark of the XBMC Foundation. HDHomeRun is a trademark of SiliconDust.

The Timer settings tab handles things like duplicate episodes, and the defaults are fine. Press OK, then Enable, and restart Kodi as the wiki recommends after changing PVR settings. The waiter has finally found the kitchen.

TV, Guide and recording

Back on the home screen, TV now shows Guide, Channels, Recordings and Timers instead of a telling off. My lists are empty because the test machine has no aerial plugged in (it is a very sad little box), but yours fills up as soon as the backend has scanned your Freeview channels. If the guide ever gets out of step, Settings > PVR & Live TV > Guide > Clear data wipes Kodi’s copy and pulls it fresh from the backend.

With Tvheadend, recording is the dessert. Pick a programme in the guide and choose Record, or press record while watching and Kodi follows the Instant recording action in Settings > PVR & Live TV > Recording. In Timers > Add timer you choose the type:

  • Recording: One time records a single slot.
  • Recording: Timer rule repeats on a schedule.
  • Recording: Timer rule (guide-based) follows a programme through the guide, which is how you record a whole series automatically.
Kodi add timer dialog listing One time, Timer rule and guide-based Timer rule recording types
Timer types offered by the Tvheadend HTSP Client in Kodi. Screenshot: official Kodi 21.2 with the default Estuary skin on my own test machine, October 2026 (menus match Kodi 21.3). Kodi is a trademark of the XBMC Foundation. HDHomeRun is a trademark of SiliconDust.

Recordings are stored by the backend, not by your Kodi box, so you can record in the living room and watch in the bedroom on any Kodi in the house. Tvheadend can also pause and rewind live TV. Go and put the kettle on. The telly will wait.

What about Kodi 22 Piers?

The first Kodi 22 release candidate arrived on 10 October 2026, the PVR menus work the same way, and Team Kodi’s post lists a fix for guide timestamps so they stay valid beyond 2038. Finally, I can plan my telly for 2039. If you are moving up, read the Kodi 21 to 22 pre-flight checklist first, and back up Kodi properly before you touch anything.

The recipe card

  1. Aerial into a DVB-T2 tuner (for HDHomeRun in the UK: the FLEX QUATRO HDFX-4DT, or an older model ending in DT).
  2. Choose your backend: HDHomeRun on its own for live TV and guide, or Tvheadend if you want Kodi to record.
  3. Get live TV working in the backend first.
  4. Install the official PVR client from Kodi’s repository (or your Linux packages).
  5. Configure it, enable it, restart Kodi.
  6. Guide, pick a programme, Record.

Sources: Kodi wiki: PVR, Kodi wiki: PVR/Backends, Kodi wiki: Tuner cards, Kodi wiki: Tvheadend HTSP Client, Kodi wiki: HDHomeRun Client, kodi-pvr/pvr.hdhomerun source, SiliconDust: HDHomeRun DVB, Tvheadend docs: Tuners, Tvheadend project page, kodi.tv: Kodi 22 Piers RC 1. Checked 17 October 2026 on official Kodi 21.2 with the official PVR clients on my test machine.

Best IPTV boxes to buy

These are media boxes and sticks that can run players and licensed apps. The first six are Google certified Android TV or Google TV devices with Google Play. The three Fire TV Sticks run Amazon’s own systems with the Appstore instead of Google Play: the 4K Max and 4K Plus run Fire OS, which is Android based, while the new Fire TV Stick 4K (2026) runs Vega OS, which does not allow sideloading Android apps, only Appstore apps. The last one, the Formuler, runs its own Android and is not certified. They are not pirate hardware. They do not come with channels or playlists. I am not claiming I personally lab-tested every SKU this month.

Pick a Google TV box when you want Play Store apps on a proper TV OS or a dedicated player behind the sofa. Pick a Fire TV Stick when Prime Video and the Appstore already cover what you watch. If you need an Android player from outside the Appstore, skip the Vega OS stick.

Whichever you pick, check that the app you need is in its store before you pay. And none of these boxes or sticks magically make unlicensed streams legal.

Written by Dr Husham Memar

Related Articles