Add-on:PVR WMC Client

From Official Kodi Wiki
Jump to navigation Jump to search

PVR WMC Client

See this add-on on the showcase

Author: KrustyReturns and scarecrow420

Repo: repo v21 repo v20 repo v19

License: GPL-2.0-or-later
Source: Source code
Summary: PVR WMC Client
Home icon grey.png   ▶ Add-ons ▶ PVR WMC Client
Attention talk.png Need help with this add-on? See here.

A PVR client to interface with Windows Media Center's Recording and EPG services. Thanks to Tomba73 and Hoopsdavis. Special thanks to DBurckh.


This add-on is installed from the Add-on browser located in Kodi as follows:

  1. Settings
  2. Add-ons
  3. Install from repository
  4. PVR clients
  5. PVR WMC Client
  6. Install

For Linux, see... Ubuntu PVR add-ons

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


pvr.wmc is a PVR client add-on that provides Live TV, PVR functions and electronic program guide data to Kodi. The services are provided by connecting to ServerWMC; a server interface for Windows which communicates with Windows Media Center.

Supported Platforms

The ServerWMC backend must be installed on a Windows PC running either Windows 7, WIndows 8 or Windows 8.1 which must have Windows Media Center (WMC) installed and configured.

  • Android - Currently in Alpha testing. Additional information can be found here:
  • AppleTV - Reported working on Crystalbuntu using the 'Linux 32-bit' build but does not seem to support HD channels even with the Broadcomm card YMMV
  • ATV2 - Independently supported (Thanks Stiefelland) but does not seem to support HD channels YMMV
  • Linux 32-bit - Officially supported
  • Linux 64-bit - Officially supported
  • OS X - Officially supported
  • Raspbmc - Officially supported and included with Raspbmc
  • Windows - Officially supported
  • Xbian - Officially supported (Now available through the official Xbian repo)

Note: Regarding versions for other distros: "PVR add ons are the responsibility of the distro builder when it comes to Raspberry Pi, Ouya etc. there is no official repo for these devices. The reason it's included in Raspbmc is someone convinced the builder to include it. If you want this add on included in your distro of choice you need to convince the builder to include it. Official Kodi pvr add ons are built automatically, pre release/testing add ons need to be added by the builder. Just because pulling it from one distro and adding it to another works now does not mean it will continue to work with later releases." (From the Kodi forums - Thanks Dilligaf for clearing this up for us.)

Supported Skins

pvr.wmc works with ALL skins. This refers only to 'Set Series Recording' and 'Delete Series Recording' dialogs. If your favorite skin isn't on the list, please contact your skin developer and request support for these features. (In the mean time, you can manage your series recordings through WMC.)

  • Confluence - Non-Windows users please see Enabling set series recording and cancel series recording at the bottom of this page.
  • Amber
  • Arctic
  • Aeon MQ5
  • Rapier
  • xTV-SAF

Downloading & Installing

Installing with Kodi

  1. Go to Settings -> Add-ons -> Install from repository -> PVR Clients and select the PVR WMC Client add-on
  2. Select "Configure"
  3. For Linux installation see... Ubuntu PVR add-ons

Installing Manually

Configuring Kodi PVR Addon to connect to ServerWMC

  • Within Kodi , navigate to {{highlight|Settings -> Add-ons -> Enabled Add-ons -> PVR Clients} and select the Windows Media Center add-on
  • Select "Configure"

  • ServerWMC Backend Hostname or IP - The hostname or IP address of the server where ServerWMC and WMC is installed
    • If backend and frontend run on the same machine then 'localhost' or '' can be used.
    • If the hostname of the server is not known, go to the System Properties window on the server (WinKey + Pause/Break). The hostname is listed under Computer Name. For non-Windows based clients (Linux, Raspbmc, etc.), hostnames may not properly resolve. It is highly recommended on these clients to enter the IP address of the server.

  • ServerWMC Backend Port - The port on which clients will communicate with the server.
    • The default is 9080. This should match the port specified within ServerWMC on the General Tab.

Using pvr.wmc

Before starting pvr.wmc for the first time, please see Configuring Live TV to ensure LiveTV is enabled within Kodi

pvr.wmc confirms to the standard operation of any Kodi pvr client. General information can be found here: The Basics of Live TV and Recording. pvr.wmc also has features that are unique allowing it to behave much like a standard STB-DVR. These features are outlined below. Since pvr.wmc uses WMC as a backend, recordings can be initiated and managed directly within WMC as well.

Recording with pvr.wmc

Series Recording

Series recordings can be initiated from the Kodi EPG when using a compatible skin. To schedule a series recording, please follow the steps below:

  • Navigate to the program guide. Highlight the program you wish to record. In the example below, we will be scheduling "Grey's Anatomy" to record:

PVR Confluence EPG.png

  • Press the 'info' button on your remote or keyboard. (Default keyboard press is "i"). You will see the "Programme info" screen. Select "Add Timer" at the bottom.

PVR Confluence Program Info.png

  • You will the see the "Record" dialog. Choose yes to record.

PVR Confluence Record.png

  • You will now see the "Recording Preference" screen. Here you can choose to "Record this Episode Only" or "Record the Series". If "Record the Series" is selected, additional series recording options will become available.
    • Show type
      • New and rerun - Records all episodes of the selected show.
      • New only - Skips recording episodes marked as repeats in the EPG
      • Live only - Records the episode ONLY if marked as "live" in the EPG.
    • Channel - Specifies the channel on which the series should be recorded.
    • Airtime - Specifies the airtime at which the series should be recorded.

PVR Confluence Recording Preference.png

On the Fly

pvr.wmc supports on-the-fly recording. If record is pressed while viewing a program, a recording timer will be created which spans from the time the channel was tuned until the scheduled end time of the program per the EPG (plus any padding specified in ServerWMC). If record is pressed again while that timer is active and tuned to the same channel, the timers expiration time will be extended by the time specified on the 'Record' tab in ServerWMC. When the timer expires recording will terminate unless the channel is still being viewed in which case recording will continue until the channel is changed or Live TV is exited. Recording is performed by ServerWMC. If the ServerWMC application is terminated at any point during an on-the-fly recording, the recording will be terminated as well.

Troubleshooting / FAQ


Note: If you are having issues and need to request assistance in the Kodi forums, it is mandatory to provide a copy of the log files!!! They contain important information that is instrumental in diagnosing issues and recommending solutions. Please copy the contents of the file to pastebin and include the link in your post. Posting of log files directly to forum threads is strictly prohibited per the rules of the Kodi Forums. Log files can be opened directly from the ServerWMC interface. They can be manually located in \ProgramData\VDsoftware\ServerWMC\. In many cases an Kodi log file can be helpful as well.

  • I am unable to set and delete series recordings - These actions can be performed directly through the WMC interface. This can also be done directly through Kodi though Confluence is the only skin directly supported at this time. Please see Enabling 'set series recording' and 'cancel series recording' for information on enabling this feature within Kodi .

  • This works great after configuring it in WMC for a few days but then crashes or has an empty EPG! - If you have previously disabled WMC services on the PC running ServerWMC, please re-enable them so WMC is able to automatically download new EPG data.

  • My EPG is empty but background downloads are enabled. - There have been reported cases of a rare condition where the WMC database can become corrupted, possibly from a failed EPG download. When WMC is opened, it will automatically check the integrity of the databases and repair if necessary. Opening WMC and allowing it to check/repair should be all that is needed to correct this condition.

  • How do I add channel icons? - Channel icons are extracted from WMC and provided to all pvr.wmc clients. Unfortunately, WMC does not populate channel icons on it own. You must add them using 3rd party software. MyChannelLogos is a quick and easy way to add these logos to WMC and in turn to pvr.wmc clients. There is a small donation required for the program but it is worth it as it works flawlessly. (As of this writing, the minimum donation is $5).

  • When editing channel information in Kodi (System/Live TV/General/Channel Manager) it appears to save but reverts back to the previous settings. - This information must be edited within WMC itself. If you wish add/hide channels, edit names, etc., it should be done through the WMC interface (Tasks/Settings/TV/Guide/Edit Channels).

  • I can view copy-once channels through WMC, does that mean they will work in Kodi using pvr.wmc? - Unfortunately no. We are limited to copy-freely channels only as are all of the other Live TV solutions available for Kodi .

  • The video quality is terrible! - If the video content being provided is interlaced, you need to enable deinterlacing within Kodi . With a channel playing, press 'M' to access the player menu. Choose the camera icon and set 'Deinterlace' to 'Auto'. You should then scroll to the bottom of that menu and select 'Set as default for all videos' before exiting. The 'Deinterlace method' and 'Video scaling method' will vary by system. You will have to try different settings here to see what works best for you. In most cases, setting both to 'Auto' is sufficient.


  • With WMC active, how do you stop it from launching when using the greenbutton to launch Kodi ? - There are many options for taking care of this issue. The easiest we have discovered thus far can be found here: . This also adds many other useful features when using an RC6 remote with Kodi and not using EventGhost.

  • I upgraded to Windows 8.1 from Windows 8 (on the server) and now TV doesn't work - There is a known issue with the Windows 8.1 upgrade process causing issues with an existing ServerWMC installation. Re-installing ServerWMC after the 8.1 upgrade is complete will correct the issue.


OS X specific troubleshooting here.


  • My client is unable to connect to my 'Recorded TV' folder - With Linix based clients, user:pass credentials are required even when the Windows share is shared with "Everyone". Please enter user name and password information on the Folders tab within ServerWMC. This can be the main log-on information for the PC hosting ServerWMC or an account could be created specifically for this purpose. Please ensure the folder is shared with the user whose credentials are entered.

Raspberry Pi

  • When I try to view a TV channel, I only get audio and the music visualizer screen (no video) - Streaming Live TV from ServerWMC to the pvr.wmc plug-in on Raspbmc requires the MPEG-2 codec be purchased from the Raspberry Pi store and installed. Though not known to be needed for pvr.wmc, it is recommended to purchase and install both the MPEG-2 and VC-1 codecs while you are there.

  • My client is unable to connect to my 'Recorded TV' folder - With Linix based clients, user:pass credentials are required even when the Windows share is shared with "Everyone". Please enter user name and password information on the Folders tab within ServerWMC. This can be the main log-on information for the PC hosting ServerWMC or an account could be created specifically for this purpose. Please ensure the folder is shared with the user whose credentials are entered.


Code for the pvr.wmc client is available here:

Information on compiling your own Linux client can be found here: (Thanks to doublea)

If you are interested in assisting with development of ServerWMC, please PM krustyreturns on the Kodi Forum

Additional guides and links

Advanced Topics

Enabling set 'series' recording and 'cancel' series recording

As of build 1013, these files only need to be manually copied on non-Windows clients. If you are using a non-Windows client, please continue. If you are using a build of pvr.wmc prior to 1013, please update now.

In the ‘resources’ folder of the add-on there are two xml skin files created for Confluence named 'DeleteTimer.xml' and 'RecordPrefs.xml'. These files need to be manually added to the Confluence skin folder (on Windows, C:\Program Files (x86)\Kodi\addons\skin.confluence\720p). Alternatively, you create a symbolic link to these files in the Confluence folder.

If you aren't using Confluence, you can add these files to the skin folder you are using. The dialogs will look funky since they are designed for Confluence (they should work though). You can modify these files to look right in whatever your skin of choice is if you are so inclined.

Once installed, when first trying to record a show after the initial confirmation, a new dialog will open (if it’s a TV series) asking if you want to record the series. Similar for when you go to delete a timer, if it’s a series timer, it will ask if you want to delete the whole series-timer.