PVR

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, 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.

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 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.

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 skinning 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 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 XBMC PVR Addons Repo

1. HTS Tvheadend

• Backend OS: Linux
• Homepage: lonelycoder.com
• Addon maintainer: dushmaniac
• Forum support topic: XBMC forum
• Backend Installation: https://www.lonelycoder.com/redmine/projects/tvheadend/wiki

2. VDR

• Backend OS: Linux
• Homepage: tvdr.de
• Addon maintainer: FernetMenta
• Addon Forum support topic: XBMC forum
• Backend Installation: http://linuxtv.org/vdrwiki/index.php/VDR_installation

3. MythTV

• Backend OS: Linux
• Homepage: mythtv.org
• Addon maintainer: dteirney
• Addon Forum support topic: XBMC forum
• Backend Installation: http://www.mythtv.org/wiki/Packages

4. MediaPortal

• Backend OS: Windows
• PVR addon OS: Windows, Linux
• Homepage: team-mediaportal.com
• Addon maintainer: margro
• Addon Forum support topic: 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: 4therecord.eu
• Addon maintainers: margro, red-f
• Addon Forum support topic: 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: 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 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 compile XBMC yourself, or use a 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

Windows

• To compile PVR addons for Windows first make sure you meet the 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. For more information on how to use Git, see the Git_Usage page If using TortiseGit, follow the 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 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. For more information on how to use Git, see the Git_Usage page.
• Start by executing:

 $ ./bootstrap

• To install add-ons into /path/to/XBMC:

 $ ./configure --prefix=/path/to/XBMC
 $ make install

• To build all PVR add-ons as .zip archives:

$ ./configure
$ make zip

Configure Live TV

• Enabling Live TV in XBMC