PVR: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>DesG
(Added DVB-T2 link)
>Robweber
No edit summary
Line 1: Line 1:
{{frodo}}
{{frodo}}
<!--{{:PVR/Contents}}-->
<!--{{:PVR/Contents}}-->
As of v12 (Frodo), XBMC supports Personal Video Recorder (PVR) controls and features when paired with a PVR "backend". 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 allowing the user to watch live TV, scheduled recordings, time shift (not yet supported), etc.
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 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.
Due to the somewhat complicated nature of setting up PVR for XBMC, this guide was created to help users from start to finish.


=original how-to (needs updating)=
==PVR History==
This page explains how to setup XBMC to be a [http://en.wikipedia.org/wiki/Digital_video_recorder PVR]. This allows you to watch live TV, listen to radio, view an EPG, schedule recordings and enables many other TV related features.


The PVR functionality of XBMC is currently under (heavy) development. Not everything will work properly yet and you can expect occasional crashes while using this. Also, the documentation here could be outdated as development progresses.
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 users still had to view EPG data and schedule recordings via the backend interface. Each of these sources was also part of the XBMC core codebase, so changes in the backend API often broke the integration until XBMC pushed out an update.  


== Hardware ==
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 custom interfaces for PVR and add them to various XBMC skins.  
If you want to watch TV on your PC, you'll need at least one supported tuner card or a provider that provides IPTV access. That tuner hardware doesn't have to be installed on the same computer on which you want to watch TV. We'll call the computer with the tuner hardware the '''backend'''. The computer used to view TV will be called the '''frontend'''. The backend and frontend can be one and the same machine. XBMC will be run on the frontend.


=== Linux ===
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.
If your backend runs Linux, have a look at these pages to find compatible hardware:
* [http://linuxtv.org/wiki/index.php/DVB-C_Devices DVB-C tuners] - for digital cable television
* [http://linuxtv.org/wiki/index.php/DVB-S_Devices DVB-S tuners] - for digital satellite television
* [http://linuxtv.org/wiki/index.php/DVB-S2_Devices DVB-S2 tuners] - for digital HD satellite television
* [http://linuxtv.org/wiki/index.php/DVB-T_Devices DVB-T tuners] - for digital Terrestrial television
* [http://linuxtv.org/wiki/index.php/DVB-T2_Devices DVB-T2 tuners] - for digital Terrestrial television (Used in UK,Finland,Sweden,Italy for HD transmission)
* analogue tuners - (fill me in)


=== Windows ===
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.
A list of supported tuners can be found [http://wiki.team-mediaportal.com/1_MEDIAPORTAL_1/11_Preparing_Your_System/01_Supported_TV_Cards here].


== Backends ==
== Supported Backends ==
XBMC currently supports the following backends:
If you want to use a PVR addon with XBMC, there are a few prerequisites. First, you need a TV tuner, and 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]
# HTS Tvheadend
# VDR
# MythTV
# MediaPortal
# For The Record
 
You'll have to install (at least) one of them.


=== 1. HTS Tvheadend ===
=== 1. HTS Tvheadend ===
Line 40: Line 23:
* Addon maintainer: dushmaniac
* Addon maintainer: dushmaniac
* Forum support topic: [http://forum.xbmc.org/showthread.php?t=91716 XBMC forum]
* Forum support topic: [http://forum.xbmc.org/showthread.php?t=91716 XBMC forum]
* Installation: '''?'''
* Installation: https://www.lonelycoder.com/redmine/projects/tvheadend/wiki


=== 2. VDR ===
=== 2. VDR ===
Line 46: Line 29:
* Homepage: [http://www.tvdr.de/ tvdr.de]
* Homepage: [http://www.tvdr.de/ tvdr.de]
* Addon maintainer: FernetMenta
* Addon maintainer: FernetMenta
* Forum support topic: [http://forum.xbmc.org/showthread.php?t=45314 XBMC forum]
* Addon Forum support topic: [http://forum.xbmc.org/showthread.php?t=45314 XBMC forum]
* Installation: The source code of the vdr-plugin-vnsiserver server is included in the pvr-addons repo. Binaries for Ubuntu can be installed e.g from [https://launchpad.net/~wsnipex/+archive/xbmc-xvba xbmc-xvba]
* Installation: http://linuxtv.org/vdrwiki/index.php/VDR_installation


=== 3. MythTV ===
=== 3. MythTV ===
Line 53: Line 36:
* Homepage: [http://www.mythtv.org/ mythtv.org]
* Homepage: [http://www.mythtv.org/ mythtv.org]
* Addon maintainer: dteirney
* Addon maintainer: dteirney
* Forum support topic: [http://forum.xbmc.org/showthread.php?t=82015 XBMC forum]
* Addon Forum support topic: [http://forum.xbmc.org/showthread.php?t=82015 XBMC forum]
* Installation: Follow the MythTV [http://www.mythtv.org/docs/mythtv-HOWTO-1.html#ss1.2 quick start up guide] to get a backend running. Once that is up you can use the the integrated myth protocol, [http://wiki.xbmc.org/?title=MythTV see wiki page for more information]. XBMC 12 (Frodo) Alpha 5 doesn't not have a PVR plugin for MythTV.
* Installation: http://www.mythtv.org/wiki/Packages


=== 4. MediaPortal ===
=== 4. MediaPortal ===
Line 61: Line 44:
* Homepage: [http://www.team-mediaportal.com/ team-mediaportal.com]
* Homepage: [http://www.team-mediaportal.com/ team-mediaportal.com]
* Addon maintainer: margro
* Addon maintainer: margro
* Forum support topic: [http://forum.xbmc.org/showthread.php?t=65488 MediaPortal Python plugin/PVR addon], [http://forum.xbmc.org/forumdisplay.php?f=136 XBMC PVR development section]
* Addon Forum support topic: [http://forum.xbmc.org/showthread.php?t=65488 MediaPortal Python plugin/PVR addon]
* Installation: Follow the MediaPortal quick setup [http://wiki.team-mediaportal.com/1_MEDIAPORTAL_1/13_Quick_Setup/2_TV_Quick_Setup guide] to get the TV server running. MediaPortal needs a plugin, TVServerXBMC, to communicate with XBMC. Download it from [http://www.scintilla.utwente.nl/~marcelg/xbmc/tvserverxbmc.html here] and copy it to the MediaPortal's TVServer plugin directory. Open up the MediaPortal TVServer Configuration page and select the TVServerXBMC plugin. Then go to Manual Control in the tree and stop the TVServer service, wait a few seconds, and start it up. MediaPortal is now able to communicate with XBMC. For a more complete guide go to margro's page [http://www.scintilla.utwente.nl/~marcelg/xbmc/mppvr-doc.html here]
* Installation: http://wiki.team-mediaportal.com/1_MEDIAPORTAL_1/12_Installation


=== 5. For The Record Argus TV Server ===
=== 5. For The Record Argus TV Server ===
Line 69: Line 52:
* Homepage: [http://www.4therecord.eu/ 4therecord.eu]
* Homepage: [http://www.4therecord.eu/ 4therecord.eu]
* Addon maintainers: margro, red-f
* Addon maintainers: margro, red-f
* Forum support topic: [http://www.4therecord.eu/forum/viewtopic.php?f=41&t=2425 ForTheRecord forum]
* Addon Forum support topic: [http://www.4therecord.eu/forum/viewtopic.php?f=41&t=2425 ForTheRecord forum]
* Installation: Install '''For The Record''', configure and enable the ForTheRecord PVR addon in XBMC.
* Installation: http://www.4therecord.eu/wiki/index.php?title=English_Installation_Guide
'''Note:''' this addon is not yet in opdenkamp's git repo as it is still under development. See margro/red-f's git repo's for the sources. Margro's XBMC-Eden-PVR builds include a beta version of this PVR addon.
 
== XBMC ==
As was told in the first paragraph, the PVR functionality in XBMC is under development. It's not a part of the mainline source tree yet, so you'll have to install XBMC a bit differenty.
 
=== Installation ===
 
==== Ubuntu ====
'''Note:''' You find better XBMC PVR packages (pulse-eight) on this [http://www.loggn.de/ubuntu-xbmc-repository-11-eden-airplay-pvr-livetv/ Repository-Overview] for Ubuntu 12.04 and older.
 
There are prebuilt packages available for Ubuntu Karmic, Lucid and Maverick.
 
To install them, open a terminal windows via Applications -> Accesoires -> Terminal and enter the following commands:
<pre>sudo apt-get remove xbmc xbmc-bin xbmc-data xbmc-skin-confluence xbmc-standalone ## remove a previous XBMC installation
sudo add-apt-repository ppa:lars-opdenkamp/xbmc-pvr ## add the PVR ppa
sudo apt-get update
sudo apt-get install xbmc xbmc-standalone</pre>
 
==== From source ====
The sources can be found on [https://github.com/opdenkamp GitHub]. At the time of writing, the stable repository is [https://github.com/opdenkamp/xbmc-antiquated/tree/Dharma-pvr Dharma-pvr]. The development repository is [https://github.com/opdenkamp/xbmc master].
 
To get the stable source on your pc, execute these commands on the command line (you must have git installed):
<pre>git clone git://github.com/opdenkamp/xbmc-antiquated.git
cd xbmc-antiquated
git checkout Dharma-pvr</pre>
 
To get the development source, execute this command:
<pre>git clone git://github.com/opdenkamp/xbmc.git</pre>
 
Now you can follow the normal compile instructions (but those will probably need updating):
* [[HOW-TO compile XBMC for Linux from source code]]
* [[HOW-TO compile XBMC for Windows from source code]]
 
==== Windows ====
Dushmaniac provides a precompiled package for Windows users based on the latest code revisions. Check [http://xbmc.opdenkamp.eu/ here] for install package.
 
Margro provides a precompiled package for Windows users based on the stable XBMC Dharma version extended with PVR support. See [http://www.scintilla.utwente.nl/~marcelg/xbmc/prebuild.html his website] for the Dharma+PVR installer.
 
=== Configuration ===
Configuration for XBMC is a two step process. First the pvr addon must be configured then enabled. Once the addon is able to connect to the backend service XBMC Live TV settings can be set. Follow the steps below to setup the individual PVR addons.
 
==== TVHeadend ====
'''Ubuntu Only'''
Install tvheadend from the opdenkamp ppa above
 
<pre>sudo apt-get install tvheadend</pre>
 
You'll be asked for an administrator username and password for the tvheadend web interface set these as you desire.
 
The tvheadend backend is now available on http://localhost:9981 in your web browser or substitute your machines IP to access it over a network.
 
Once in the web interface click the Configuration tab, then click the TV Adapters tab and select your TV adapter from the dropdown on the left. You can now click Add DVB Network by location... select your location and let tvheadend scan the muxes. Or if your location isn't listed click multiplexes and you can add the muxes manually. Once all your channels are listed in the Services tab go back to the general tab and click Map DVB services to channels. Now click on the Digital Video Recorder tab and set the location where you'd like to store recordings. Select the Access Control tab, click Add Entry, set all the tick boxes to on and double click in the boxes to set the username and password, this needs to be a different username and password to the admin one supplied during installation.
 
This is the abbreviated setup there are many more options available to tweak but this will get you up and running quickly.
 
Load XBMC, goto System, goto Add-Ons, select Installed Add-ons from the list, select PVR Clients, select Tvheadend HTSP Client. Select Enable, select Configure, set the username and password to the values you just created in the TVHeadend control panel, set IP Address if accessing over a network.
 
Head back the the Settings menu, select Live TV, Select Enable.
 
Back out to the Main Menu and hit (cross your fingers) Live TV.
 
==== VDR ====
?
[[PVR-BACKEND-VDR| VDR Backend]]
 
==== MythTV ====
 
The pulse-eight packaged xbmc's mythtv client does not work.  Here's one that does:  https://github.com/tsp/xbmc
 
Ubuntu build instructions here:  http://forum.xbmc.org/showpost.php?p=915301&postcount=133


==== MediaPortal ====
== Configuring XBMC ==
The Mediaportal addon has a configuration page within the addon itself. Using the Confluence skin go to System > Add-ons > Installed Add-ons > PVR clients > MediaPortal PVR > Configure. Set the '''Mediaportal Hostname''' to the IP address of the computer with MediaPortal TVServer installed (default 127.0.0.1 is fine if the computer with XBMC and Mediaportal are on the same machine). Set the '''Mediaportal recordings directory''' to the share that MediaPortal saves it's TV recording to. That's it, select OK to save options.
Once you have a working backend, you can begin the process of getting the right addon to work with XBMC. The official backend addons are a part of the [https://github.com/opdenkamp/xbmc-pvr-addons XBMC PVR Addons Repo]


==== XBMC Live TV ====
'''more info needed here'''
After you have a working PVR addon you are able to configure Live TV. Got to System > Live TV. In the General tab select the Enabled radio. XBMC will try to start the PVR addons, if it is successful the other options will no longer be grayed out and you can modify all the other settings. If it is not able to successfully start any of the PVR addons an Error message will appear.
#Getting the repo
#Compiling
#Getting the addon to XBMC




Revision as of 19:26, 28 September 2012

Template:Frodo As of v12 (Frodo), XBMC supports 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 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.

PVR History

XBMC has long had support for viewing recordings from backend recording services such as MythTV and TVHeadend through the use of specialized video sources that communicate with the backend software. This did not allow XBMC to be used a true PVR frontend since users still had to view EPG data and schedule recordings via the backend interface. Each of these sources was also part of the XBMC core codebase, so changes in the backend API often broke the integration until XBMC pushed out an update.

Serious efforts to create a PVR frontend for XBMC started with a project during Google Summer of Code 2008. Project student 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 custom interfaces for PVR and add them to various XBMC skins.

With the release of XBMC 10.0 (Dharma) came the addition of the 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.

During the development cycle for XBMC 12.0 (Frodo) the merge of the PVR and mainline XBMC branches was approved during the 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

If you want to use a PVR addon with XBMC, there are a few prerequisites. First, you need a TV tuner, and working backend to connect to XBMC. Below is a list of currently supported backends. The source for these addons can be found in the XBMC PVR Addons Repo

1. HTS Tvheadend

2. VDR

3. MythTV

4. MediaPortal

5. For The Record Argus TV Server

Configuring XBMC

Once you have a working backend, you can begin the process of getting the right addon to work with XBMC. The official backend addons are a part of the XBMC PVR Addons Repo

more info needed here

  1. Getting the repo
  2. Compiling
  3. Getting the addon to XBMC
Retrieved from "https://kodi.wiki/index.php?title=PVR&oldid=25187"