Raspberry Pi Kodi and TVheadend Server

  • Raspberry Pi Kodi and TVheadend Server
  • $25.00

 (0 reviews)
  • Product Code: rpi3kthpkis_27082017_001
  • Availability: In Stock
- +

Image Zip file containing Raspberry Pi 3 Model B compatible image with latest Raspbian operating system Includes pre-installed applications Kodi, TVheadend Server, PITV EPG support, htop, shellinabox and a interactive master menu to easily setup up your network, attached storage, network shares and pre-installed drivers and firmware to support popular peripheral devices. With the Wi-Fi headless configuration you can also connect your Raspberry Pi on boot up to your Wi-Fi network (headless). Built in menu allows configuration of Kodi to be enabled or disabled on boot. Once purchased and downloaded the extracted image is then written to a MicroSD card and inserted into your Raspberry Pi turning your Raspberry Pi into an instant Kodi and TVheadend integrated server.

Want to stream or record your IPTV subscriptions, Terrestrial Radio or TV stations or channels into your home / office network, record and play on demand?, TVheadend is a TV streaming server and recorder for Linux supporting DVB-S, DVB-S2, DVB-C, DVB-T, ATSC, ISDB-T, IPTV, SAT>IP as input sources

Worried about finding the correct transmission frequencies?, not to worry, run the pre-installed w_scan utility to generate and find all local services (dependent on peripheral devices connected) . Yes, that means wherever you are in the world you can easily find your TV channels.

Worried about tuning your aerial into the best signal strength?, not to worry the TVheadend server has a built in signal strength meter so you can have your mobile device in your hand as you position and lock your aerial into the best signal available!

Want a fully integrated media center frontend?, Kodi (formerly known as XBMC) is an award-winning open source (GPL) software media player and entertainment hub which integrates seamlessly into TVheadend to provide live TV viewing, recording, electronic program guides and FM radio.

Why buy an image?, Pre-built images save you the time and frustration of trying to compile all your v4l drivers, firmware, pitv EPG (Electronic Program Guide) and TVheadend server and also includes a advanced configuration menu to allow easy setup of your Raspberry Pi network, attached storage and allows choice of enabling Kodi to run on boot up or not.

What do you get?

***Please note the Raspberry Pi Kodi and TVheadend Server image does not contain and film media and the images below are purely for demonstration purposes only.

Headless Wi-Fi setup  (no need for xterm) connects your Raspberry Pi automatically to the preferred Wi-Fi network by simply editing and existing file on the dos partition before inserting it into your Raspberry Pi.

TVheadend Server for Raspberry Pi 3 Model B with pre-installed v4l drivers, firmware and XMLTV PITV EPG Grabber Module.

Kodi Server for Raspberry Pi 3 Model B with pre-installed TvHeadend HTSP Client. Or connect and Kodi server to the TVheadend server backend.

KODI and TVheadend Server playback.
Use TVheadend Client free app available for Android and IOS or VLC to connect to your TV streaming server and simply channel hop and manage features.

Advanced configuration menu

The advanced and popular configuration menu easily configures the Raspberry Pi network and storage by simply selecting a option from the interactive network menu then answer basic configuration questions. After simple menu driven configuration a quick reboot provides the mounted drives or shares for access.

Main menu options are listed below;
  • Network Configuration - Configure Raspberry Pi network.
  • Media Configuration -  Configure Raspberry Pi storage.
  • Kodi Configuration - Enable or disable Kodi on boot up.
  • Raspi Config - Run Raspi-Config Menu.
  • Exit - Exit this menu without rebooting.
  • Exit & Reboot - Exit and reboot your Raspberry Pi.
  • About - About this configuration tool.
Network configuration sub menu options are listed below;
  • Install Wireless AP - Setup Raspberry Pi onboard Wi-Fi Access Point.
  • Install Wireless client - Connect Raspberry Pi to a Wi-Fi network.
  • Set static LAN IP - Setup a static LAN IPv4 address.
  • Install DNS/DHCP Server - Setup Raspberry Pi LAN as DNS and DHCP server.
  • IP Forward & Masquerade (Ethernet) - WLAN --> LAN.
  • IP Forward & Masquerade (Wi-Fi) -  LAN --> WLAN.
  • Restore Network Config - Restores the original default Raspberry Pi network configurations.
  • Exit - Return to main menu without rebooting.
Media configuration sub menu options are listed below;
  • USB Drives (NTFS) - Mount ntfs usb drives and make it persistent.
  • Shared Drives - Mount NAS, NFS, CIFS or Windows shares
  • Exit - Return to main menu without rebooting.
Kodi configuration sub menu options are listed below;
  • Enable Kodi - Enable Kodi on boot up.
  • Disable Kodi - Disable Kodi on boot up.
  • Exit - Return to main menu without rebooting.

Main menu

See sub menus...

Htop is an interactive system-monitor process-viewer. It is designed as an alternative to the Unix program top. It shows a frequently updated list of the processes running on the Raspberry Pi, normally ordered by the amount of CPU usage. Htop is enabled by default.


Shellinabox is a web based terminal that uses Ajax technology to provide the look and feel of a native shell. Using this, as long as your device has a browser, you can remote shell access your Raspberry Pi. (remote view of htop using shellinabox is pre-installed). As with Htop, Shellinabox is also enabled by default.


South African DTT ( more information can be found here for Sentech)

DTT stands for Digital Terrestrial Television (or Transmission). It refers to the terrestrial, or land-based, broadcasting of digital television. South African television is currently broadcast in an analogue format with the country in the process of switching over to DTT.


Channels, completely free (free-to-air)

Radio Stations (19): SAFM, Lesedi FM, Lotus FM, Metro FM, Motsweding FM, Ukhozi FM, Radio 2000, RSG, Munghana Lonene FM, Channel Africa, X-K FM, Umhlobo Wenene, Ikwekwezi FM, Tru FM, Thobela FM, Phalaphala FM, Good Hope, 5FM and Ligwalagwala FM.
TV Channels (9):SABC1, SABC2, SABC3, SABC NEWS, Beatlab TV, e.tv HD, eMovies+, eExtra and eToonz.
Now PVR it and stream it to your entire home or office!

• Pre-installed 2017-08-16 Raspbian Stretch Lite.
• Pre-installed HTS Tvheadend 4.3-
• Pre-installed Kodi Krypton 17.3.
• Pre-installed w_scan utilities.

• Pre-installed PITV EPG(Electronic Program Guide) Grabber Module.
• Pre-installed v4l drivers and firmware for popular devices.
• Pre-installed Htop and Shellinabox system monitoring and web based terminal utilities.
• Enabled FTP service. provides simple ease of access to transfer media to and from the Raspberry Pi.
• Download and Installation instructions on this web page (bottom), supplementary videos, no lengthy complicated instructions.

2017-06-21 Raspbian Jessie Lite
• Product Type- Zip File
• Download File Size - +- 2.6 Gb
• TVheadend version
HTS Tvheadend 4.3-271~g940c694
• Compatibility- Raspberry Pi 3 Model B

• Compatibility- Raspberry Pi 2 Model B+

• Memory-SD - 8Gb or greater, recommend writing to class 10 or higher microSDHC UHS-I card (not supplied).

Download and Installation Instructions

- Install FileZilla Client on your computer. Available from Sourceforge.
- Download the sitemanager file from your client account downloads section after your purchase.
- Import the sitemanager file into FileZilla.
- Connect using the new sitemanager drop-down link created by the imported sitemanager file.
- Drag and drop or double click on your zipped image to start FTP download.
- Extract the image using your favorite unzip program.
- Write the image to the MicroSD card using your favorite image tool, we recommend Win32DiskImager available from Sourceforge.
- If you want to configure a headless wireless connection edit the wpa_supplicant.conf.example with your details and save it as wpa_supplicant.conf.
- Insert the MicroSD card into your Raspberry Pi 3 Model B, connect tuners, peripheral devices,networks and storage devices.
- Power on your Raspberry Pi 3 Model B.

Installation and setup video: Raspberry Pi Kodi & TVheadend Server #1.

Please note that in this version a default user name admin and password admin is set on the TVheadend server

How to setup PITV IPTV on TVHeadend: Raspberry Pi Kodi & TVheadend Server #2.

To patch epg for PITV to pitv.za.com domain copy and paste code below into a terminal session and press enter.

sudo curl -o ./patch.sh --progress-bar https://iiot.co.za/downloads/epg_patch_pitv.sh
sudo chmod +x ./patch.sh
sudo ./patch.sh

Important Notes & Tips

The image will automatically resize on first boot to utilize the full space available on your MicroSD card.
The image automatically starts tvheadend on reboot.
Login to console or remote terminal session with user pi password raspberry and run the following two commands.

To scan for available channels / services you first need to stop the tvheadend application, type the following commands.

sudo killall -9 tvheadend
sudo w_scan -x
Once your scan is completed and you have the information needed remember to reboot your Raspberry Pi.
To list the available URL's to access your device features as well as further instructions either look at the Raspberry Pi console screen greeting message or type.
sudo cat /etc/issue 
TVHeadend already has default user admin created with password admin.
Then connect to your new TVheadend server from a remote computer using the URL from above ( format is http://ipaddress:9981 )
Root username is root password raspberry.
Standard username is pi password raspberry.
SSH and FTP access is enabled for user root.
To open the channel list on VLC connect to http://ipaddress:9981/playlist/channels then click view, channel list.
Please visit http://tvheadend.org for further configuration documentation.

Enabling and integrating Kodi

To enable Kodi to load on boot up run the included advanced configuration menu by typing (Below) then select Kodi Configuration menu then Enable on boot up option.
sudo /home/pi/main-menu
First configure a username and password for the kodi integration on the tvheadend backend server web interface and allow HTSP streaming rights.
Add the configuration to Kodi under addons -> my addons -> PVR Clients -> TvHeadend HTSP Client as follows

TvHeadend hostname or IP address: localhost
HTTP port: 9981
HTSP port: 9982
Username: (As set on TVheadend backend)
Password: (As set on TVheadend backend)
Connection Timeouts and Response timeouts work fine as default setting.


If you have or want to use a kodi instance loaded on another PC then the above procedure can be used to connect remotely to the Raspberry Pi TVheadend server by using the IPv4 address of the Raspberry Pi instead of "localhost".

General information

For support with the installation instructions please log a request on http://helpdesk.iiot.co.za
This image has been successfully tested in South Africa (Gauteng) for DTT DVB-T2 with a MyGica T230C usb dvb-t2 using Ellies Channel 21-68 AASG or AA1B antennae.
Please drop us some feedback so we can better your shopping and product experience.

Tvheadend Manual

Click here for Tvheadend manual

Write a review

Note: HTML is not translated!
    Bad           Good

Tags: kodi, tvheadend, raspberry pi, server, media server, media, pitv, pitv server

Related Products