PVR: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>Robweber
(grammer, url changes)
m (Updated for v20)
 
(172 intermediate revisions by 23 users not shown)
Line 1: Line 1:
{{frodo}}
{{PVR_guide}}
<!--{{:PVR/Contents}}-->
{{mininav}}
As of v12 (Frodo), XBMC supports [http://en.wikipedia.org/wiki/Digital_video_recorder Personal Video Recorder (PVR)] controls and features when paired with a PVR "backend". This allows you to watch live TV, listen to radio, view an EPG, schedule recordings and enables many other TV related features. A PVR backend is a second process/application that can either run on the same machine running XBMC, on a stand-alone device (able to feed several XBMC machines), or completely by itself with XBMC only running when needed. When paired with a backend, XBMC handles the interface, or frontend, allowing the user to watch live TV, scheduled recordings, time shift (not yet supported), etc.


Due to the somewhat complicated nature of setting up PVR for XBMC, this guide was created to help users from start to finish.
__TOC__


==PVR History==
<section begin="intro" />Answers to some common questions regarding Live TV, PVR and Radio which may help you understand the requirements for setting up and using this powerful component of {{kodi}}.<section end="intro" />


XBMC has long had support for viewing recordings from backend recording services such as MythTV and TVHeadend through the use of specialized [[List_of_media_source_types#Videos_Specific_Sources|video sources]] that communicate with the backend software. This did not allow XBMC to be used a true PVR frontend since user still had to view EPG data and schedule recordings via the backend interface. These file sources were also part of the XBMC core codebase, so updates to the backend API often broke the integration until XBMC pushed out an update.  
{| width="100%"
|-
{{FAQ|
| BGcolor=
| Question= What is Live TV, PVR and Radio?
| Answer= Live TV, PVR and Radio refers to the traditional broadcast systems of receiving TV and Radio channels through your rooftop antenna, satellite dish or cable provider. <br>
These signals can be received and viewed within {{kodi}}.
}}
{{FAQ|
| BGcolor=
| Question= What is the benefit of this?
| Answer= Think of this as your own TiVO setup, but with greater control. <br>
* You can watch, pause and rewind Live TV and Radio channels
* Record, save and watch later any program
* Schedule future timers as a one-off or record a series automatically
* Set keyword recordings. Add the title to be recorded, and when it is eventually broadcast it will be recorded automatically
* View the EPG ''(Electronic Program Guide)'' and set reminders and timers
* and many more features depending on the backend you have chosen.
}}
{{FAQ|
| BGcolor=
| Question= Why don't I see any channels?
| Answer= {{kodi}} does not have its own embedded TV-tuning functionality. Instead it acts as a frontend for the Live TV component. To use this feature you require:
# A '''tuner card''' capable of receiving Terrestrial/OTA ''(Over The Air)'' or Cable signals via a coaxial cable connection. The same antenna cable that you would plug into the back of your TV.
# The '''backend software''' ''(the server)'' that works in the background to receive the TV and Radio signals and enables the Live TV and PVR functions described earlier.
# The '''{{kodi}} add-on''' ''(the client)'' for the backend software you have installed. This enables transferring all those backend features into the {{kodi}} user interface.
}}
{{FAQ|
| BGcolor=
| Question= Which tuner card works with {{kodi}}?
| Answer= {{Kodi}} has no particular requirement as the tuner card interfaces with the operating system and the backend software and not directly with {{kodi}}. <br>
: See '''[[PVR/Tuner cards|Tuner Cards]]'''
}}
{{FAQ|
| BGcolor=
| Question= Which backend should I install?
| Answer= There are numerous backend and other PVR software options to choose from to fit your requirement.
: See: '''[[PVR/Backends|Backends]]'''
}}
{{FAQ|
| BGcolor=
| Question= Where do I obtain the {{kodi}} add-on?
| Answer=
The PVR add-ons are available from the official {{kodi}} repository in the ''PVR clients'' section.<br>
The PVR add-ons for Linux are manually installed based on the distro. Ubuntu is the only official distro. Other distros may not be as well supported as Ubuntu. See... '''''[[Ubuntu_PVR_add-ons|Ubuntu PVR Add-ons]]'''''
}}
{{FAQ|
| BGcolor=
| Question= Do I install a tuner card and backend software on every device?
| Answer= No. The backend can act as a server and stream the TV and radio signal over your local network. All that is required is the appropriate PVR add-on installed on every {{kodi}} device that needs to access Live TV.
}}
{{FAQ|
| BGcolor=
| Question= Can I add my streaming services like Netflix and Amazon?
| Answer= Not to the Live TV section. Streaming services are classed as a Video Add-on which are installed from the Kodi Repository and accessed from the Add-ons menu. The Live TV and PVR section can only accommodate the backends that receive Terrestrial and Satellite signals and also some IPTV services.
}}
{{FAQ|
| BGcolor=
| Question= How does {{kodi}} receive the EPG?
| Answer= There are three commonly available methods used by the backend:
# In many countries the EPG is transmitted with the TV and Radio signal and the backend will scan this and populate the EPG.
# An internet based EPG service that offers a higher quality EPG with frequent daily updates for a monthly fee.
# '''[https://sourceforge.net/projects/xmltv/ XMLTV]''' which is a set of separate programs that can download guide data from a variety of sources on the internet.
}}
{{FAQ|
| BGcolor=
| Question= Is there a guide to help me set this up?
| Answer=
Follow the pages in this guide.<br>
Most of the setup effort will be with the tuner card and the backend software. Once they have been setup, it is a simple matter of installing the {{kodi}} addon and configuring the settings.<br>
Ensure you have the backend software working correctly before attempting to install and use the {{kodi}} addon.
}}
|}


Serious efforts to create a PVR frontend for XBMC started with a project during [[GSoC_-_Unified_PVR_Frontend|Google Summer of Code 2008]]. Project student [[User:Alcoheca|Alcoheca]] began the fork of what would eventually become the XBMC PVR branch. As this project became more mature it opened the door for skinners to start taking advantage of skinning interfaces for PVR and add them to various XBMC skins.


With the release of XBMC 10.0 (Dharma) came the addition of the [[Add-ons|addon]] framework to XBMC. Although binary addons were not available, the PVR branch of XBMC started to use these as a structure for having various backends plug-in to a common API structure.
{{next|[[PVR/Tuner_cards|'''''Select a Tuner card''''']]}}


During the development cycle for XBMC 12.0 (Frodo) the merge of the PVR and mainline XBMC branches was approved during the [[XBMC_DevCon|XBMC Devcon]]. This made the PVR API available to all mainstream XBMC users, although the addons are still to be maintained in a separate repository and not distributed with XBMC releases.


== Supported Backends ==
{{top}}
If you want to use a PVR addon with XBMC, there are a few prerequisites. First, you need a TV tuner or IPTV source, and a working backend to connect to XBMC. Below is a list of currently supported backends. The source for these addons can be found in the [https://github.com/opdenkamp/xbmc-pvr-addons XBMC PVR Addons Repo]
{{updated|20}}


=== 1. HTS Tvheadend ===
* Backend OS: Linux
* Homepage: [http://www.lonelycoder.com/hts/tvheadend_overview.html lonelycoder.com]
* Addon maintainer: dushmaniac
* Forum support topic: [http://forum.xbmc.org/showthread.php?t=91716 XBMC forum]
* Backend Installation: https://www.lonelycoder.com/redmine/projects/tvheadend/wiki
=== 2. VDR ===
* Backend OS: Linux
* Homepage: [http://www.tvdr.de/ tvdr.de]
* Addon maintainer: FernetMenta
* Addon Forum support topic: [http://forum.xbmc.org/showthread.php?t=45314 XBMC forum]
* Backend Installation: http://linuxtv.org/vdrwiki/index.php/VDR_installation
=== 3. MythTV ===
* Backend OS: Linux
* Homepage: [http://www.mythtv.org/ mythtv.org]
* Addon maintainer: dteirney
* Addon Forum support topic: [http://forum.xbmc.org/showthread.php?tid=110694 XBMC forum]
* Backend Installation: http://www.mythtv.org/wiki/Packages
=== 4. MediaPortal ===
* Backend OS: Windows
* PVR addon OS: Windows, Linux
* Homepage: [http://www.team-mediaportal.com/ team-mediaportal.com]
* Addon maintainer: margro
* Addon Forum support topic: [http://forum.xbmc.org/showthread.php?t=65488 MediaPortal Python plugin/PVR addon]
* Backend Installation: http://wiki.team-mediaportal.com/1_MEDIAPORTAL_1/12_Installation
=== 5. For The Record Argus TV Server ===
* Backend OS: Windows
* PVR addon OS: Windows, Linux, OS X, iOS
* Homepage: [http://www.4therecord.eu/ 4therecord.eu]
* Addon maintainers: margro, red-f
* Addon Forum support topic: [http://www.4therecord.eu/forum/viewtopic.php?f=41&t=2425 ForTheRecord forum]
* Backend Installation: http://www.4therecord.eu/wiki/index.php?title=English_Installation_Guide
=== 6. DVBLink TV Server ===
* Backend OS: Windows
* PVR addon OS: Windows
* Addon maintainers: zeroniak
* Addon Forum support topic: [http://www.dvblogic.com/phpBB3/viewtopic.php?f=61&t=19703 DVBLink forum]
* Backend Installation: http://dvblogic.com/phpBB3/index.php
== Configuring XBMC ==
Once you have a working backend, you can begin the process of getting the matching PVR addon compiled and installed into XBMC. You must have a build version of XBMC compiled after [https://github.com/xbmc/xbmc/pull/1357 PR:1357] was merged into the master repository. This should be any build after September 4, 2012. Once Frodo is released the PVR components of XBMC will become part of the official release. Until then you must [[:Category:Compiling|compile XBMC yourself]], or use a [http://mirrors.xbmc.org/nightlies/ nightly build].
The PVR Addons are not distributed with XBMC. They reside in a separate repository located at [https://github.com/opdenkamp/xbmc-pvr-addons https://github.com/opdenkamp/xbmc-pvr-addons]
===Windows===
* To compile PVR addons for Windows first make sure you meet the [[HOW-TO:Compile_XBMC_for_Windows|compiling prerequisites]] for compiling XBMC. The same features are needed to compile the PVR addons.
* Once the requirements are met, clone the PVR addon repository: [https://github.com/opdenkamp/xbmc-pvr-addons https://github.com/opdenkamp/xbmc-pvr-addons]. For more information on how to use Git, see the [[Git_Usage]] page If using TortiseGit, follow the [[HOW-TO:Compile_XBMC_for_Windows#Getting_the_sources|cloning instructions here]], substituting the correct repository URL.
* Download the build dependencies by executing the batch file found in project\BuildDependencies\
* Open the solution file located in project\VS2010Express\xbmc-pvr-addons.sln
* Select the wanted configuration "Debug" or "Release"
* Press F7 to build the solution
'''Note:''' The build system does not yet generate .zip archives
Workaround: copy the wanted pvr addons to your XBMC installation by hand.
Example: addons\pvr.demo\addon\*.* => YOUR_XBMC_DIR\addons\pvr.demo\*.*
===Linux===
*To compile PVR addons for Linux first make sure you meet the [[HOW-TO:Compile_XBMC_for_Linux|compiling prerequisites]] for compiling XBMC. The same features are needed to compile the PVR addons.
*Once the requirements are met, clone the PVR addon repository: [https://github.com/opdenkamp/xbmc-pvr-addons https://github.com/opdenkamp/xbmc-pvr-addons]. For more information on how to use Git, see the [[Git_Usage]] page.
*Start by executing:
<source lang="bash">
$ ./bootstrap
</source>
*To install add-ons into /path/to/XBMC:
<source lang="bash">
$ ./configure --prefix=/path/to/XBMC
$ make install
</source>
* To build all PVR add-ons as .zip archives:
<source lang="bash">
$ ./configure
$ make zip
</source>
===Configure Live TV===
* Enabling Live TV in XBMC
[[Category:How-to]]
[[Category:Guides]]
[[Category:PVR]]
[[Category:PVR]]
[[Category:Karellen]]

Latest revision as of 04:52, 25 January 2023

Live TV, PVR & Radio Contents

PVR main page

1. Tuner Cards
2. Backends
3. Setup
4. Live TV Artwork

Related Pages:

All PVR Pages
All PVR Add-on Pages

Home icon grey.png   ▶ PVR

Answers to some common questions regarding Live TV, PVR and Radio which may help you understand the requirements for setting up and using this powerful component of Kodi.


What is Live TV, PVR and Radio?

Live TV, PVR and Radio refers to the traditional broadcast systems of receiving TV and Radio channels through your rooftop antenna, satellite dish or cable provider.
These signals can be received and viewed within Kodi.


What is the benefit of this?

Think of this as your own TiVO setup, but with greater control.

  • You can watch, pause and rewind Live TV and Radio channels
  • Record, save and watch later any program
  • Schedule future timers as a one-off or record a series automatically
  • Set keyword recordings. Add the title to be recorded, and when it is eventually broadcast it will be recorded automatically
  • View the EPG (Electronic Program Guide) and set reminders and timers
  • and many more features depending on the backend you have chosen.


Why don't I see any channels?

Kodi does not have its own embedded TV-tuning functionality. Instead it acts as a frontend for the Live TV component. To use this feature you require:

  1. A tuner card capable of receiving Terrestrial/OTA (Over The Air) or Cable signals via a coaxial cable connection. The same antenna cable that you would plug into the back of your TV.
  2. The backend software (the server) that works in the background to receive the TV and Radio signals and enables the Live TV and PVR functions described earlier.
  3. The Kodi add-on (the client) for the backend software you have installed. This enables transferring all those backend features into the Kodi user interface.


Which tuner card works with Kodi?

Kodi has no particular requirement as the tuner card interfaces with the operating system and the backend software and not directly with Kodi.

See Tuner Cards


Which backend should I install?

There are numerous backend and other PVR software options to choose from to fit your requirement.

See: Backends


Where do I obtain the Kodi add-on?

The PVR add-ons are available from the official Kodi repository in the PVR clients section.
The PVR add-ons for Linux are manually installed based on the distro. Ubuntu is the only official distro. Other distros may not be as well supported as Ubuntu. See... Ubuntu PVR Add-ons


Do I install a tuner card and backend software on every device?

No. The backend can act as a server and stream the TV and radio signal over your local network. All that is required is the appropriate PVR add-on installed on every Kodi device that needs to access Live TV.


Can I add my streaming services like Netflix and Amazon?

Not to the Live TV section. Streaming services are classed as a Video Add-on which are installed from the Kodi Repository and accessed from the Add-ons menu. The Live TV and PVR section can only accommodate the backends that receive Terrestrial and Satellite signals and also some IPTV services.


How does Kodi receive the EPG?

There are three commonly available methods used by the backend:

  1. In many countries the EPG is transmitted with the TV and Radio signal and the backend will scan this and populate the EPG.
  2. An internet based EPG service that offers a higher quality EPG with frequent daily updates for a monthly fee.
  3. XMLTV which is a set of separate programs that can download guide data from a variety of sources on the internet.


Is there a guide to help me set this up?

Follow the pages in this guide.
Most of the setup effort will be with the tuner card and the backend software. Once they have been setup, it is a simple matter of installing the Kodi addon and configuring the settings.
Ensure you have the backend software working correctly before attempting to install and use the Kodi addon.


Next step: Select a Tuner card


Return to top