Tvheadend: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Remove OpenELEC)
(96 intermediate revisions by 12 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:Backend software:Tvheadend}}{{:PVR/Contents}}
{{:PVR/Contents}}
Tvheadend is a TV streaming server for Linux supporting DVB-S, DVB-S2, DVB-C, DVB-T, ATSC, IPTV, and Analog video (V4L) as input sources and can be used as a PVR backend of XBMC.
{{mininav|[[PVR]]|[[Recording software]]}}
<section begin="intro" />'''Tvheadend''' is a popular open source TV streaming [[PVR backend]] (TV tuner and DVR recording server) software application for Linux supporting DVB-S(2), DVB-C(2), DVB-T(2), ATSC, IPTV (UDP/HTTP), and Analog video (V4L) as input sources. Tvheadend it can be used as a [[PVR backend]] of {{Kodi}}. Version 3.4 and later of Tvheadend include support for timeshifting (pausing of Live TV).


==Important notes about Tvheadened==
Tvheadend does not currently support Timeshifting or live rewind, however all other PVR functions work with no known issues.


==Setting up Tvheadened==
__TOC__
*Link(s) to (or have a copy of on a subpage) backend setup guide
{{-}}
==Overview==
'''Tvheadend''', formerly named "HTS Tvheadend", was previously part of the HTS (Home Theater System) software suite before it spun of into its own project for it as a dedicated PVR backend software product.


==Connect XBMC to Tvheadened==
By levering existing third-party [[PVR backend]] applications such as '''Tvheadend''' that specialize in receiving television signals and support a [[wikipedia:client–server model|client–server model]] which {{Kodi}} can access via a [[PVR|PVR client addon]], these PVR features allows you to watch Live TV, listen to radio, view a EPG TV-Guide, schedule recordings and enables many other TV related features, all using {{Kodi}} as your primary interface once the initial pairing connection to '''Tvheadend''' have been done and and configuration of the [[PVR|PVR client addon]] for it is complete.<section end="intro" />
*Rest of page will be about setting up this backend's PVR add-on


{{#lst:Add-on:Tvheadend HTSP Client|Settings}}
== Preinstalled options ==
The following Kodi/OS distributions come with Tvheadend already installed, or easily installed as an option. These are great one-stop solutions that can greatly simplify the installation of the backend, as well as various other benefits unique to those distros.
 
* [[LibreELEC]] - LibreELEC is a [[JeOS implementations for Kodi]] that comes packaged with the Tvheadend backend software and a Tvheadend Kodi PVR add-on.
 
 
== Installing Tvheadend ==
;Basic
:Most Debian and Ubuntu installations can take advantage of the standard [[w:Advanced Packaging Tool|APT]] installation methods for getting Tvheadend installed, either using a GUI package manager, or from the command line using "<code>apt-get install tvheadend</code>". The install procedure normally creates a user named "hts", which is the user Tvheadend will run as. You should check that the "hts" user has sufficient permissions to your tuner (usually /dev/dvb/adapter0/frontend0). Running the command "<code>sudo adduser hts video</code>" should be sufficient.
 
:For more info, see: https://tvheadend.org/projects/tvheadend/wiki/Download
 
;Raspberry Pi
:The easiest way to get Tvheadend on the Raspberry Pi series is to use [[LibreELEC]], or a other [[JeOS implementations for Kodi]]. You can also use the Arch Linux ARM instructions below if you are using Arch Linux ARM on a Raspberry Pi.
 
;Arch Linux
{{see|HOW-TO:Install Tvheadend on Arch Linux}}
(including PogoPlug)
 
;Synology NAS
:You can install Tvheadend from the Syno Community repo through the DiskStation Manager: http://www.synocommunity.com/repository
 
== Tvheadend quick start guide ==
{{warning|1=This section is probably outdated. Please use an alternative guide such as '''[http://forum.kodi.tv/showthread.php?tid=270385 this]''' for now.}}
 
;{{Note|This is just the most basic steps needed to get a signal from your PVR backend to Kodi. This guide probably doesn't include everything you will want to do, like name channels, get the electronic programming guide (EPG/TV guide) set up, remove channels, etc.
::For help with those features see '''[[#Additional guides and links]]'''.}}
 
{| cellpadding="8" cellspacing="0"
|- valign="top" bgcolor="whitesmoke" |
| '''1.''' || Make sure Tvheadend is up and running ''(see here for details: https://tvheadend.org/projects/tvheadend/wiki/Install_and_initial_setup )''
|- valign="top" |
| '''2.''' || All configuration is done in a web browser. If you are on the same machine that Tvheadend is installed then point your browser to <nowiki>http://localhost:9981</nowiki> . If you are on a different machine than Tvheadend, then point your browser to <nowiki>http://IP.ADDRESS.GOES.HERE:9981</nowiki> , where IP.ADDRESS.GOES.HERE = the IP address of the machine that Tvheadend is installed on. ''For example: <nowiki>http://192.168.0.3:9981</nowiki>''
|- valign="top" bgcolor="whitesmoke" |
|  '''3.''' || [[File:tvheadend1.png|right|border]]
# Click on the '''Configuration''' tab
# Click on the '''TV Adapters''' tab
# Click on the arrow for the drop-down menu
# Select your TV tuner adapter
 
If your tuner hardware is not detected or is having issues, check http://linuxtv.org for driver support.
This example is for a DVB Tuner: Terrestrial TV Standard Definition. It is worth checking the hardware you purchase is supported using the LinuxTV.org link above. Also the low cost Satellite units have very poor hardware support. However DVB and DVB2 units are easy to purchase, low cost and reliable, even on modest hardware running Kodi such as Raspberry Pi. For Freeview a Free to Air (FTA) service in the UK you need a DVB2 adaptor.''(See here for details: https://en.wikipedia.org/wiki/DVB-T2)''
 
 
|- valign="top" |
| '''4.''' || [[File:tvheadend2.png|640px|right|border]] You will see a window like this. Now you will want to click on "'''Add DVB Network by location'''".
|- valign="top" bgcolor="whitesmoke" |
| '''5.''' || [[File:tvheadend3.png|right|border]]
# From the menus select your location and the type of signal you are trying to receive. In this example we're using a generic list for QAM, a US signal for cable TV.
# Then click "'''Add DVB Network'''" at the bottom.
|- valign="top" |
| '''6.''' || [[File:tvheadend4.png|right]] Wait for the number under "'''Muxes awaiting initial scan'''" to reach zero. If the number under "'''Services'''" is also zero, then that means Tvheadend has not picked up any channels. You may need to check your hardware or if you've selected the right signal type (step 5), or even your tuner driver (see http://linuxtv.org for driver support).
 
It might be possible that the firmware can't be found. Check <code>dmesg</code> for messages like the following:
<pre>[ 3931.964710] xc5000: waiting for firmware upload (dvb-fe-xc5000c-4.1.30.7.fw)...
[ 3931.970217] xc5000: Upload failed. (file not found?)</pre>
 
In this case, the Hauppauge WinTV-HVR-950Q tuner can't locate the firmware. You should download the desired firmware (the 950Q firmware can be found at http://www.kernellabs.com/firmware/xc5000/) and place in the correct directory (for Ubuntu this is <code>/lib/firmware/</code>). You should then see this message in <code>dmesg</code>:
<pre>[ 4791.147048] xc5000: firmware read 16497 bytes.
[ 4791.147049] xc5000: firmware uploading...
[ 4794.976020] xc5000: firmware upload complete...</pre>
 
|- valign="top" bgcolor="whitesmoke" |
| '''7.''' || [[File:tvheadend5.png|right|border]] Click on "'''Map DVB services to channels'''". You should now be able to pick up TV channels in Kodi once you configure the Tvheadend add-on configuration in the next section, "'''[[#Connecting Kodi to Tvheadend]]'''".
|}
 
== Connecting Kodi to Tvheadend ==
{{PVR repo notice}}
# Go to {{highlight|Settings -> Add-ons -> Enabled add-ons -> PVR Clients}} and select the Tvheadend add-on
# Select "Configure"
# By default, you should only need to fill in '''Tvheadend hostname or IP address'''.
 
<section begin="Settings" />
[[File:Tvheadend HTSP Client.settings.png|500px|right]]
{|
|
; Tvheadend hostname or IP address
: The hostname or IP address of the server where Tvheadend is installed. If on the same machine then 'localhost' can be used.
; HTTP port
: The default for Tvheadend is 9981 but this will need updating if you have changed it in the Tvheadend settings.
; HTSP port
: The default for Tvheadend is 9982 but this will need updating if you have changed it in the Tvheadend settings.
; Username
: If you have configured Tvheadend to require a username then enter it here. This can be blank.
; Password
: If you have configured Tvheadend to require a password then enter it here. This can be blank.
; Connect timeout in seconds
: The default is 10 seconds however this can be lowered if you want Kodi to timeout connections to the Tvheadend backend quicker.
; Response timeout in seconds
: The default is 5 seconds however this can be lowered if you want Kodi to timeout requests to the Tvheadend backend quicker.
|}
{{-}}
<section end="Settings" />
 
{{Next|[[Configuring live TV settings|Configuring Kodi]]}}
 
==See also==
* [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP PVR Client Addon for Kodi]]
* [[PVR|PVR in Kodi]]
** [[PVR recording software]]
* [[JeOS implementations for Kodi]]
** [[LibreELEC]]
 
 
== External links==
* Tvheadend website - https://tvheadend.org/projects/tvheadend
** [https://tvheadend.org/projects/tvheadend/wiki Documentation]
** [https://tvheadend.org/projects/tvheadend/boards Support forum]
* Tvheadend backend for Kodi support forum - http://forum.kodi.tv/forumdisplay.php?fid=168
* Using HDHomeRun products with Tvheadend - https://tvheadend.org/boards/14/topics/3368
* Using VBox TV Gateway products with Tvheadend - http://kodi.wiki/view/VBox_Home_TV_Gateway#Tvheadend
* Helper scripts for importing channels of Austrian IPTV A1 TV into Tvheadend - https://github.com/Bronkoknorb/a1tv-helpers
 
 
 
[[Category:PVR|*]]
[[Category:Live TV]]

Revision as of 03:40, 10 July 2018

PVR/Contents

Home icon grey.png   ▶ PVR ▶ Recording software ▶ Tvheadend

Tvheadend is a popular open source TV streaming PVR backend (TV tuner and DVR recording server) software application for Linux supporting DVB-S(2), DVB-C(2), DVB-T(2), ATSC, IPTV (UDP/HTTP), and Analog video (V4L) as input sources. Tvheadend it can be used as a PVR backend of Kodi. Version 3.4 and later of Tvheadend include support for timeshifting (pausing of Live TV).



Overview

Tvheadend, formerly named "HTS Tvheadend", was previously part of the HTS (Home Theater System) software suite before it spun of into its own project for it as a dedicated PVR backend software product.

By levering existing third-party PVR backend applications such as Tvheadend that specialize in receiving television signals and support a client–server model which Kodi can access via a PVR client addon, these PVR features allows you to watch Live TV, listen to radio, view a EPG TV-Guide, schedule recordings and enables many other TV related features, all using Kodi as your primary interface once the initial pairing connection to Tvheadend have been done and and configuration of the PVR client addon for it is complete.

Preinstalled options

The following Kodi/OS distributions come with Tvheadend already installed, or easily installed as an option. These are great one-stop solutions that can greatly simplify the installation of the backend, as well as various other benefits unique to those distros.


Installing Tvheadend

Basic
Most Debian and Ubuntu installations can take advantage of the standard APT installation methods for getting Tvheadend installed, either using a GUI package manager, or from the command line using "apt-get install tvheadend". The install procedure normally creates a user named "hts", which is the user Tvheadend will run as. You should check that the "hts" user has sufficient permissions to your tuner (usually /dev/dvb/adapter0/frontend0). Running the command "sudo adduser hts video" should be sufficient.
For more info, see: https://tvheadend.org/projects/tvheadend/wiki/Download
Raspberry Pi
The easiest way to get Tvheadend on the Raspberry Pi series is to use LibreELEC, or a other JeOS implementations for Kodi. You can also use the Arch Linux ARM instructions below if you are using Arch Linux ARM on a Raspberry Pi.
Arch Linux
See: HOW-TO:Install Tvheadend on Arch Linux

(including PogoPlug)

Synology NAS
You can install Tvheadend from the Syno Community repo through the DiskStation Manager: http://www.synocommunity.com/repository

Tvheadend quick start guide

Stop hand.png This section is probably outdated. Please use an alternative guide such as this for now.


Note: This is just the most basic steps needed to get a signal from your PVR backend to Kodi. This guide probably doesn't include everything you will want to do, like name channels, get the electronic programming guide (EPG/TV guide) set up, remove channels, etc.
For help with those features see #Additional guides and links.
1. Make sure Tvheadend is up and running (see here for details: https://tvheadend.org/projects/tvheadend/wiki/Install_and_initial_setup )
2. All configuration is done in a web browser. If you are on the same machine that Tvheadend is installed then point your browser to http://localhost:9981 . If you are on a different machine than Tvheadend, then point your browser to http://IP.ADDRESS.GOES.HERE:9981 , where IP.ADDRESS.GOES.HERE = the IP address of the machine that Tvheadend is installed on. For example: http://192.168.0.3:9981
3.
Tvheadend1.png
  1. Click on the Configuration tab
  2. Click on the TV Adapters tab
  3. Click on the arrow for the drop-down menu
  4. Select your TV tuner adapter

If your tuner hardware is not detected or is having issues, check http://linuxtv.org for driver support. This example is for a DVB Tuner: Terrestrial TV Standard Definition. It is worth checking the hardware you purchase is supported using the LinuxTV.org link above. Also the low cost Satellite units have very poor hardware support. However DVB and DVB2 units are easy to purchase, low cost and reliable, even on modest hardware running Kodi such as Raspberry Pi. For Freeview a Free to Air (FTA) service in the UK you need a DVB2 adaptor.(See here for details: https://en.wikipedia.org/wiki/DVB-T2)


4.
Tvheadend2.png
You will see a window like this. Now you will want to click on "Add DVB Network by location".
5.
Tvheadend3.png
  1. From the menus select your location and the type of signal you are trying to receive. In this example we're using a generic list for QAM, a US signal for cable TV.
  2. Then click "Add DVB Network" at the bottom.
6.
Tvheadend4.png
Wait for the number under "Muxes awaiting initial scan" to reach zero. If the number under "Services" is also zero, then that means Tvheadend has not picked up any channels. You may need to check your hardware or if you've selected the right signal type (step 5), or even your tuner driver (see http://linuxtv.org for driver support).

It might be possible that the firmware can't be found. Check dmesg for messages like the following:

[ 3931.964710] xc5000: waiting for firmware upload (dvb-fe-xc5000c-4.1.30.7.fw)...
[ 3931.970217] xc5000: Upload failed. (file not found?)

In this case, the Hauppauge WinTV-HVR-950Q tuner can't locate the firmware. You should download the desired firmware (the 950Q firmware can be found at http://www.kernellabs.com/firmware/xc5000/) and place in the correct directory (for Ubuntu this is /lib/firmware/). You should then see this message in dmesg:

[ 4791.147048] xc5000: firmware read 16497 bytes.
[ 4791.147049] xc5000: firmware uploading...
[ 4794.976020] xc5000: firmware upload complete...
7.
Tvheadend5.png
Click on "Map DVB services to channels". You should now be able to pick up TV channels in Kodi once you configure the Tvheadend add-on configuration in the next section, "#Connecting Kodi to Tvheadend".

Connecting Kodi to Tvheadend

Template:PVR repo notice

  1. Go to Settings -> Add-ons -> Enabled add-ons -> PVR Clients and select the Tvheadend add-on
  2. Select "Configure"
  3. By default, you should only need to fill in Tvheadend hostname or IP address.


Tvheadend HTSP Client.settings.png
Tvheadend hostname or IP address
The hostname or IP address of the server where Tvheadend is installed. If on the same machine then 'localhost' can be used.
HTTP port
The default for Tvheadend is 9981 but this will need updating if you have changed it in the Tvheadend settings.
HTSP port
The default for Tvheadend is 9982 but this will need updating if you have changed it in the Tvheadend settings.
Username
If you have configured Tvheadend to require a username then enter it here. This can be blank.
Password
If you have configured Tvheadend to require a password then enter it here. This can be blank.
Connect timeout in seconds
The default is 10 seconds however this can be lowered if you want Kodi to timeout connections to the Tvheadend backend quicker.
Response timeout in seconds
The default is 5 seconds however this can be lowered if you want Kodi to timeout requests to the Tvheadend backend quicker.



Next step: Configuring Kodi


See also


External links