XBMC with PVR Support

Under Construction This article is recently under construction. You may find errors and missing content in it. You're free to correct and contribute - or to visit this page later again. You may want to refer to "Contribute to our Wiki".

Latest news: · 2014-08: XBMC "Gotham" 13.2 released · 2014-08: XBMC is now called "Kodi" (version numbering is continued; Kodi starts with V14 (aka "Helix")), this article still refers to the name "XBMC". Kodi is 100% compatible (but uses slightly different naming in menues) with "XBMC Gotham" (13.x) · This article is also valid for OpenELEC installations later than Openelec version 4.0

Prologue - Some words about Kodi & XBMC

For those of you knowing already, what XMBC is about and for, we'd like to share some words about Kodi 14 (Helix), XBMC 13 (Gotham), XBMC 12 (Frodo) and former version XBMC 11 "Eden"; the current version is XBMC Gotham 13.2, upcoming: Kodi Helix 14.0 by the time of writing.

Whether you're new to XBMC or an already happy user - we urgently recommend to use the latest stable version.

A smiling flashback to earlier versions

XBMC Frodo (XBMC 12.0) and Eden (XBMC 11) came both with NO support for ARGUS TV (by that time, it was called "For the Record") - with Frodo 12.2 there came the happy-making message: "ARGUS TV PVR functionality is included now!" - and countless bug corrections had been made. A ARGUS TV forum member did the whole development of integrating ARGUS TV into XBMC - by that time with special builds only. A huge thank to RedF and all the early testers. Only since Frodo 12.2 the ARGUS TV PVR Client is automatically included) and thus earlier versions are not covered anymore by this Wiki article.
If you want to know about XBMC Frodo "before-12.2" or even XBMC 11 (Eden), please visit the article Archive: XBMC 11.0 (Eden) with PVR Support. Eden's and early Frodo's specific installation information has been wiped out of this (active) XBMC article. Maybe interesting: below screenshots are (still) taken from a Frodo 12.0-specifical build with ARGUS TV PVR-Addon. And... they're still valid :)

About Kodi & XBMC

XBMC is a free and open source media center developed by the XBMC Foundation, a non-profit technology consortium. XBMC is available for multiple operating-systems and hardware platforms, for use with televisions and remote controls. It allows users to play and view most videos, music, podcasts, and other digital media files from local and network storage media and the internet. OpenELEC is a specific Linux build of XBMC with a stripped-down dedicated Linux kernel serving only XBMC on multiple platforms (also suitable for low-end processors and hardware). (see XBMC Website and Wikipedia Kodi/XBMC for a complete description, OpenELEC Website and Wikipedia OpenELEC)

Kodi & XBMC ARGUS TV PVR Support

XBMC with ARGUS TV PVR support... click to enlarge →

ARGUS TV PVR functionality is part of the "official XBMC Frodo Repository".
Please note: "Live TV" menu entry is simply called "TV" under Kodi "Helix"

Download & Installation Instructions

Download & install of Frodo with PVR funtionality - recommended way

Prerequisites

No prerequisites.

Download & Installation

Download

ARGUS TV 2.0.1 or later has to be installed. ARGUS TV 2.0 or earlier will not work properly with this description. Get it here Download of XBMC for Windows If you want to stay with the latest official Release: download Frodo under XBMC Downloads "For the time after": If you want to stay with nightly builds of XBMC later than Frodo Release: download Frodo Nightly later than 2013-01-29 from XBMC File Repository - Mirror List. Download of XBMC / OpenELEC: Get the latest official or latest official Release 3.0: download OpenELEC 3.0 under OpenELEC Site

Installation

1. Install ARGUS TV 2.0.1 or later. Check that ARGUS TV is properly configured.
2. Install the downloaded Frodo (XBMC 12.0) Release (or a later nightly build). Start it and wait until all databases are properly updated.

FYI: What is a "Nightly" or "Nightly Build"?

"Nightlies" are builds that are run automatically during the night. All (ready-to-test) contributions or changes have before been added to the main development branch and will automatically be incorporated. The keyword is "ready to test" here. These changes normally have been tested on on a subsystem or component level and only few as an incorporated part of the whole system. Thus, every user using "Nightlies" have to be prepared, that the system may be unstable, maybe even (worst case) not run at all. The more mature a version is (means: beta stage or even already release candidate, not just alpha, the less incremental improvement you may expect through using latest nighlies

Get it started

To configure & to activate the ARGUS TV PVR Client, respectively the PVR functionality, please follow the steps described below.

Configuration & Activation of ARGUS TV PVR Client from within Frodo

To use the PVR functionalities within XBMC, you have to configure it in two simple steps: configure the PVR add-on for ARGUS TV properly and then activate it.
If you follow the steps to first configure the PVR add-on and then activate PVR functionality it avoids you to get some (obvious) error messages. But it's of minor importance, the ARGUS TV Client plug-in starts automatically after it has been activated. If you want to stay on the safe side, exit XBMC and restart it.

Frodo: Configuration of ARGUS TV PVR add-on

Move to the PVR Clients under System / Settings / Add-ons / Installed Add-ons / PVR Clients

• Deactivate all PVR Clients except "ARGUS TV PVR Client" (if you're using XBMC with ARGUS TV only).
  
• Configure the ARGUS TV PVR Client to your needs:
  
• The most important fields to configure
  • ARGUS TV Hostname: set the IP address or server name of the machine on which your ARGUS TV Core Services are running. Keep 127.0.0.1 for a single-seat installation (XBMC and ARGUS TV are running on the same machine).
    You may enter also a dynamic DNS entry, if you registered a dynamic DNS service and set up dynamic DNS and NAT / port forwarding on your router (→ see also our Wiki article Remote Access).
  • ARGUS TV webserver port: set to 49943 if you used the default settings when installing ARGUS TV
  • Windows User Account: set the user name of the above mentioned machine, that should be used. Usually best choice is the same user, under which ARGUS TV Core is running as well. It doesn't matter, if this user is existing on the (remote) machine on which XBMC is installed (that you configure right now), if it's a different one.
  • Password: enter the password of this user that you just entered to be used on ARGUS TV Core's machine.
• Activate ARGUS TV PVR Client → see next section.

XBMC 12.0 Frodo ARGUS TV PVR Client setup... click to enlarge →

Frodo: Activating PVR functionality

System / Settings Live TV and go to the tab General

• Activate "Enabled"
  

XBMC 12.0 Frodo System Settings / Live TV... click to enlarge →

• Adjust other settings to your needs, they're self-explanatory.
  

You will now see the PVR starting up, connecting to ARGUS TV, importing recordings and finally also the EPG.
You'll find now in the main menu the entry "Live TV" as shown in the pictures above.

Please keep in mind, that the PVR functionality as a whole is in beta stage. Not all functions are yet supported, but mature stability is already given.

Enjoy the combination of these two marvelous software packages: ARGUS TV & XBMC Frodo.

Frodo: Troubleshooting & Restrictions that you may encounter

Of course, we all may expect, that those issues & hurdles will be eliminated in the upcoming builds until release.
Nevertheless they're right now immanent and part of the beta phase. The following list may not be complete and maybe already outdated again.

Network and connectivity problems may cause XBMC (both, Eden & Frodo) to crash. Eden was sensitive when connectivity problem occurred while startin up PVR Client, Frodo still struggles with connectivity problems while scanning your file bases - the PVR Client solved its problems. If you encounter this, e.g. if you're connecting to remote shares or PVR server or reside in an unreliable network, you simply have to reconnect the network e.g. with any explorer appand wait until scanning is finished.

• Thus, most troubles come from network issues:
  • First check please, if ARGUS TV and XBMC both have full access to incoming and outgoing connections in your firewall
  • If you installed / added XBMC already earlier and selected only some ports to be opened, add the ports 49941 through 49943 to be open as well
  • Check if your port just configured in PVR Client is correct
  • If you're using dynamic DNS, check
    • that your dynamic DNS service is properly set up and active (check with your dynDNS service provider)
    • that port forwarding or NAT is set up correctly for ALL new ports (49941 through 49943)

If you encounter additional issues or find, that some of them have been fixed, please add your experience for other users. This ARGUS TV article or section needs your support. Please help us to create, correct or extend it. You may want to refer to "Contribute to our Wiki".

Differences of PVR functionality between XBMC Frodo and XBMC Eden

Please add your information, your experience and latest news here! This ARGUS TV article or section needs your support. Please help us to create, correct or extend it. You may want to refer to "Contribute to our Wiki".

This section shall reflect only the ARGUS TV PVR-related functionality, differences but also commonalities, enhancements and restrictions.

We must consider, that in the past, most of the ARGUS TV-related functionality is directly linked to the PVR Client plug-in, not to XBMC itself. Nevertheless, XBMC 12.0 (Frodo) since Beta 1 comes with mutual support of PVR Clients and since Beta 3 the ARGUS TV PVR Client us included - this will bring new features to us that (at least indirectly) also affect the ARGUS TV PVR Client plug-in.

Also, although Frodo runs much more smooth than Eden, we may expect far more: currently, Frodo Nightlies are build with the /DEBUG compiler switch, that means, the application still wears a lot of overhead and code that is needed for error analysis & investigation. This probably will lead to a "sudden boost" as soon as we get the XBMC Frodo release. So let's live with that for now...

Some obvious differences in Frodo / Eden behaviour

1. Timeshift: Frodo now supports timeshift (pause & resume) of live TV - one of the directly usable new features. Eden wasn't.
2. Channel switching: Frodo versions as per nightly of 2012-12-13 or later now support the direct input of channel numbers (plus "enter") during live TV to directly switch to another channel by LCN. Eden and Frodo including RC1 weren't.
3. Channel switching times: the channel switching times of Frodo are much shorter than with Eden
4. Sound quality: we encounter real HD sound of live TV thanks to the new sound engine of Frodo

Of course, this list is only a few headlines, please refer to below mentioned ARGUS TV thread and especially also to the site and forum of XBMC - please feel free to add points that are important to you, us and all our users.

Tips & Tricks

• After adding / editing / moving or removing channels from the back-end, you need to reset the PVR database. (EDEN + FRODO)

• Recording lifetime settings
  • 1 = keep until space needed (FRODO)
  • 2-364 = keep number of days (so lifetime from 14 --> recording deteted after 14 days)
  • 365 = keep forever

• Setting the "Tunedelay" to 0 in the ARGUS TV PVR Client's Addon Config screen will force a new stream on tuning. (FRODO)
  

This usually solves hangs on channel changes with different content channels (i.e. SD ←→ HD).

• If your EPG data is often incorrect(and correct within ARGUS TV Scheduler Console), check the "Don't save TV Guide in Database" option in the TV section. This will force a full EPG import at XBMC startup.

• If you have buffering issues / glitches on Live TV / Radio, you can try to increase the buffers to 20 for example.
  

You need to add this to XBMC's advancedsettings.xml:

  <pvr>
     <minvideocachelevel>20</minvideocachelevel>
     <minaudiocachelevel>20</minaudiocachelevel>
  </pvr>

Side effect: channel switching time will be higher.
Can't find advancedsettings.xml? More information under XBMC advancedsettings.xml

Further Information

Please read & follow the ARGUS TV Forum http://www.argus-tv.com/forum/viewforum.php?f=60. The "Development Progress" thread covers PVR functionality in detail, especially under Frodo. You will also get latest news concerning PVR functionality there.

Archive: XBMC 11.0 (Eden) with PVR Support

If you want to know about XBMC 11.0 (Eden), please visit the article Archive: XBMC 11.0 (Eden) with PVR Support. Eden's information has been wiped out of this (active) XBMC article.

Credits

Our credits go to the ARGUS TV-Users Margro, Red_F, Glenn 1990 and many other contributors of the ARGUS TV Forum. Argus "Argus-TV" ArgusTV ATV "A-TV" ForTheRecord 4TR "For The Record" Scheduler Recorder Console XBMC PVR Client "add-on" addon Eden Frodo 11.0 12.0 download setup installation