{{:PVR/Contents}}
{{mininav|[[PVR]]|[[Recording software]]}}
<section begin="intro" />'''VDR''' ('''The Video Disk Recorder''') is an open source [[PVR backend]] application for Linux designed to allow any computer to function as a DVR (Digital Video Recorder), in order to stream Live TV, radio, and record television programming using the computer's hard drive. The computer needs to be equipped with a digital TV tuner aapter (or TV tuner card). VDR uses drivers from the [[wikipedia:LinuxTV|LinuxTV project]].

By levering existing third-party [[PVR backend]] applications such as '''VDR''' 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 XBMC/Kodi as your primary interface once the initial pairing connection to '''VDR''' have been done and and configuration of the [[PVR|PVR client addon]] for it is complete.<section end="intro" />
__TOC__
{{-}}
== Installing VDR ==
{{See|PVR/Backend/VDR/Installation}}

== VDR quick start guide ==
If your tuner hardware is not detected or is having issues, check http://linuxtv.org for driver support.

* http://www.charliemarshall.com/2012/01/my-all-in-one-tv-music-file-web-ubuntu.html#vdrinstall

== Connecting Kodi to VDR ==
To connect Kodi to a backend system (VDR in our case) you first need the PVR extension (which is part of Kodi since version 12 "Frodo") and a addon depending on the backend you choose.

[[File:Xbmc-vdr-vnsi.png||right]]

There are multiple addons to connect Kodi to VDR. They are very similar but are developed from different teams. We try to list them here to allow you to choose your favorite connection type:
; VNSI: https://github.com/opdenkamp/xbmc-pvr-addons/
; XVDR: https://github.com/pipelka/xbmc-addon-xvdr

On the VDR side you need a corresponding plugin to offer the content (live TV and recordings) to XBMC. The plugin for VDR over VNSI is included in the above VNSI github (subdirectory "addons/pvr.vdr.vnsi/vdr-plugin-vnsiserver").

The situation gets a little more complicated, as the above addons have been forked a few times. Each "fork" is based on one of the above addons and extend it for a specific need. Some extend the number of supported graphic cards or try some nice features. Normally the authors of a fork "push" their changes back into their corresponding base to improve the overall situation. This is normally done, when they finished developing their specific "need".

Because PVR extension in general and also XBMC-VDR connection is very new, there are lots of forks. If you want to stay safe, we recommend to use one of the above addons (and not a derived fork). However, there may be reasons to use a derived fork.

{{PVR repo notice}}
# Go to {{highlight|Settings -> Add-ons -> Enabled add-ons -> PVR Clients}} and select the VDR add-on
# Select "Configure"

<section begin="Settings" />
[[File:VDR VNSI Client.settings.png|500px|right]]
{|
|
; VDR Hostname or IP
: The hostname or IP address of the server where VDR is installed. If on the same machine then 'localhost' or 127.0.0.1 can be used.
; VNSI Port
: The default for VDR with VNSI is 34890 but this will need updating if you have changed it in on the VDR side.
; Priority
: Priority is a VDR feature. Every task that requires a device is related to a priority. Recordings for example have a priority from 0 to 99 (default 50). Assume VDR records some tv show an the timer was set with priority 50. Now a second timer starts and no device is available. Higher priorities can interrupt lower ones. VDR defines priority for live view to 0. Since vnsi is a plugin, I defined default for live to -1
: Actually it should work with 0 and -1. If it doesn't there may be some other plugin that pretends to be a device. I would start with disabling all other plugins.
; Character Set Conversion
: If Kodi and VDR use different character sets, then enable this option to convert the texts after receiving them from VDR.
; Connect timeout(s)
: How many seconds should Kodi wait for a connection to VDR. Time is given in seconds.
; Allow VDR Messages
: Do you allow the VDR to display messages inside XBMC?
; Create channel groups automatically on the server
: ?
|}
{{-}}
<section end="Settings" />

{{Next|[[PVR/XBMC|Configuring XBMC]]}}

== Additional guides and links ==
* VDR website - http://tvdr.de
** [http://www.linuxtv.org/vdrwiki/index.php/Main_Page VDR wiki Documentation]
* [http://forum.kodi.tv/forumdisplay.php?fid=169 VDR backend for Kodi support forum]