Setup Tvheadend on a Raspberry Pi (Guide)

This guide will show you how to install TVheadend on a Raspberry Pi so that you can stream Live TV from your satellite / antenna to all networked devices in the house.

This guide assumes the following items (and therefore will not be covered in this guide):

  • OS is installed on the Raspberry Pi (e.g. DietPi)
  • Static IP has been assigned to the Raspberry Pi
  • USB TV Tuner is plugged into the Raspberry Pi USB slot

All commands throughout the guide are to be run in the Raspberry Pi Terminal either via direct access or an SSH client such as PuTTY.


  1. Install the official TVheadend APT repository:
    echo “deb raspbian-stretch main” | sudo tee -a /etc/apt/sources.list.d/tvheadend.list
    • Note: The above command refers to Raspbian Stretch, if you are using a different version ensure you update the command accordingly (e.g. raspbian-jessie).

  2. Perform a Repository update and upgrade:
    sudo apt-get update
    sudo apt-get upgrade

  3. Install TVheadend: sudo apt-get install tvheadend

  4. During the install you will be prompted a number of times. Enter Y to confirm the install a verify. When prompted for a Username and Password, ensure you enter values that you will remember for later.

  5. You will receive a screen stating that once the installation has completed TVheadend can be accessed via a specific port. Note this port number and select Ok.

  6. Note the Port number TVheadend is installed on.

Configuring TVheadend

  1. Once TVheadend has completed installing, in the web browser of a local device visit: http://raspberrypi_ipaddress:tvheadend_port
  2. Enter the Username and Password from step 4 to login to the TVheadend setup wizard

  3. TVheadend setup wizard

  4. Once in the TVheadend software perform the following actions:
    • Select Language then Save & Next
    • Enter\0 in the Allowed Network field.
      • Note: This assumes the device is only being used by your internal network and is not internet facing.
    • Enter an Admin Username and Password (I use the same as during install Step 4)
    • Eter a User Username and Password (Enter * to allow anonymous users)
    • Select Save & Next

  5. Once at the Network Settings window, in the dropdown select the USB TV Tuner you are using (likely the only option listed)

  6. Select the USB TV Tuner
    • Select Save & Next

  7. In Pre-Defined Muxes section, select your location followed by Save & Next. TVheadend will begin to scan for channels in your area. Once it reaches 100%, select Save & Next.

  8. Tick the Map all Services checkbox to make TVheadend apply channel names to each Service it found during the scan. Then select Save & Next.

  9. Tick Map all Services and then Save & Next

Configure Kodi

  1. Open Kodi and select the following:
    • Addons
    • My Addons
    • TVheadend HTSP Client
    • Configure

  2. Enter the IP address of the Raspberry Pi, as well as the Port number of the TVheadend service (same IP and Port used to access the TVheadend web interface).

  3. Enter IP of Raspberry Pi and Port of TVheadend service.

  4. Select the following:
    • Ok
    • Enable

  5. Go back to the main menu of Kodi and select TV. All channels should now be listed and you can watch live TV by selecting the channel.