XBMC with PVR Support

Revision as of 07:18, 11 December 2012

Latest news: 2012-12-08: Frodo Beta 3 is out by today. Good news! The corresponding ARGUS TV PVR Client is now included!

Whether you're new to XBMC or an already happy user - we now recommend to use XBMC Frodo (12.0), currently in its After-Beta-3 stage, instead of dealing with XBMC Eden's latest official release. The reason is simple: Frodo is already kind of "rocksolid" and as the PVR functionality is included now, also including ARGUS TV PVR Client (as per or later than Beta 3), it's much easier to install and get it working than Eden. PLUS... you have more benefit out of it (like time shifting, etc.) Stay tuned, we'll try to keep in track with the Frodo development :)

Prologue - Some words about Eden & Frodo

For those of you knowing already, what XMBC is about and for, we'd like to share some words about the upcoming XBMC 12.0 (Frodo), which is as per 8th of December in its After-Beta-3 phase - again, the XBMC developers seem to want to make us a Christmas gift - as 2011 with V 11.0 (Eden).

It's always a bit of a challenge to write a Wiki article about latest builds within a development phase, as it is outdated already the day it is published. We try to keep track - therefore stay posted.

This article is not about discussion advantages or disadvantages of Eden, Frodo or even other clients, it shall give a helping hand to those of our ARGUS TV users who want to know roughly what we're talking about, how to install - knowing about hurdles and maybe restrictions.

What you should know: Once installed / moved to Frodo, your database will get updated and thus it will not be backward compatible anymore. Moving back from Frodo to Eden is not covered in this article; you might have to re-setup Eden entirely. Please read the section Frodo: Restrictions that you currently may encounter below before installing / updating to Frodo. We give no warranty that the following description is valid for all systems or that it will run on your system; Frodo and the ARGUS TV PVR Client are still in Beta stage!

If you're using Frodo with its Nightlies or install newest PVR Client versions separately (FYI: What is a "Nightly" or "Nightly Build"? - see info box below), please watch carefully to which version/build of Frodo and PVR Client the text refers. This forth permutation of the article refers now to Frodo Beta 3 or later with the included PVR build as per 2012-12-03 (or later). Additional good news is, that also the nightlies will now always contain the latest submitted ARGUS TV PVR Client. Start from reading section XBMC 11.0 Eden with PVR Support below if you consider installing Eden instead of Frodo (not recommended anymore).

XBMC

XBMC is a free and open source media player application developed by the XBMC Foundation, a non-profit technology consortium. XBMC is available for multiple operating-systems and hardware platforms, featuring a 10-foot user interface 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. (see Wikipedia and XBMC Website for a complete description)

The current stable release is XBMC 11.0 "Eden". The following first sections of this article refer to this version of XBMC.

XBMC 12.0 Frodo with PVR Support

Be aware of: This upcoming version XBMC 12.0 Frodo is still in a Beta Stage. The will to accept errors and dysfunction for the time being is presumed. Be assured, that these potential errors are by now far less severe than with Eden and its "artificially added PVR functionality". We don't know everything, but we made some experience - if you want to avoid some of them, please follow the steps described below.

XBMC 12.0 Frodo with PVR support... click to enlarge →

PVR functionality has found entry to the "official XBMC Frodo Repository".
The even better news, that with XBMC Frodo Beta 3 and onwards, the ARGUS TV PVR Client also found its way into the standard (and thus included) repository of XBMC - this means to you much less thinking and considering... and an update will consist of Download & Run Installation - that's it.
This all means actually to us ARGUS TV users, that the PVR Client Add-on has the same basis as other PVR add-ons, too. And thus we profit out of the fundamental decision of XMBC-Team to generally support PVR functionality.

Download & Installation Instructions

Download & install of Frodo with PVR funtionality - recommended way:

Prerequisites

1. First of all & if you want to have an as smooth installation as possible, please follow those steps - explanation mentioned with the individual steps):
   1. XBMC: Disable "Update library on start-up" (a parallel scan of new videos with the parallel start-up of ARGUS TV may expand the runtime of that from 1-3 up to 15 minutes (even on powerful systems)) → go to System / Settings / Video / Library and deactivate "Update library on startup"
   2. XBMC: Disable Live TV → go to System / Settings / Live TV / General and deactivate "Enabled"
   3. Now exit XBMC and start it up again to be sure the changes have been saved. Exit it again after all initialization has been finished.

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 If you want to stay with the public Beta: download Frodo Beta (Beta 3 or later) under XBMC Downloads If you want to stay with nightly builds of XBMC later than Beta 3: download Frodo Nightly later than 2012-12-08 from XBMC File Repository - Mirror List.

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) Beta 3 or 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, 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: Restrictions that you currently 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.

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

• Experienced issues with Beta 3 or Nightly & included PVR Client:
  • Startup of PVR Client → if you select to exit Frodo again during startup & load of the PVR it may lead to a complete freeze of XBMC and you may have to kill the task / program
  • Startup time of PVR CLient → when you start XBMC and have the setting enabled to "Update library on start-up" in the video settings, the start of the PVR Client can take very long - we experienced startup times of upto 15 minutes instead of 1-3.
  • Thus decide, if you want to use XBMC Frodo as a live TV front-end or to schedule recordings, then leave the option disabled as described above in the Prerequisites above. If you use XBMC Frodo mainly as a media center for recorded shows, you may leave this active.
• Seemingly issues that are correctable (troubleshooting Frodo Betas)
  • Sometimes the start-up of the ARGUS TV PVR Client seems to hang when loading recordings from ARGUS TV core machine. If you're not tracing or using the "recorded programs" section of ARGUS TV, you may have collected maybe even thousands of entries of "recorded programs" - which even may be outdated. Delete those entries within ARGUS TV Scheduler Console by moving to "Recorded Programs" and then hit import/synchronize" - after a check of existing files, ARGUS TV will propose which programs may be deleted... do so and restart XBMC.
• Resolved issues of recent versions (subjective):
  • Beta 2 & PVR Client now speeds up the start & ending of the program, nevertheless, the restrictions above are still valid.
  • Stuttering of live TV after a certain runtime were not experienced anymore
  • PVR Client dosn't start up automatically → seems to be resolved

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 thus will bring new features 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 times: the channel switching times of Frodo are much shorter than with Eden
3. 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.

XBMC 11.0 Eden with PVR Support

Warning: If you want to have PVR support, do not use the official builds from XBMC Website, they currently do not support PVR functionality and it can't be enabled through adding add-ins. Use the prebuild packages' download link in the next section instead.

XBMC itself can not record or stream live TV or handle TV cards in its current stable release, but as XBMC is open source and expandable through plug-ins, a development branch of XBMC emerged and is kept updated closely with all upcoming releases and betas of main XBMC development.

To use XBMC as a front-end for ARGUS TV, you will need to use this branch, called "XBMC with PVR Support". It adds Live TV & Radio streaming and a (for the time being very limited) ARGUS TV Scheduling to XBMC. Through various PVR plug-ins, it can be used with a variety of TV server software. Please note, that the PVR support is in a beta phase, although it is working already very stable. As the time of writing, client-side pause/timeshift of live streams is not yet possible and scheduling a recording is possible only in a very limited way (only one-time recordings so far).

Downloads Complete prebuild packages and versions with PVR support can be found under Prebuild Versions For those who always want to stay on the edge of latest development, the PVR binaries - more often updated - can be found under PVR Binaries

Warning: Current version is XBMC 11.0 Eden, the next version XBMC 12.0 Frodo is in an early Alpha Stage and the use of it can only be advised to experienced users who are willing to accept errors and dysfunction for the time being - if so, please read XBMC 12.0 Frodo below.

Both of the above can freely installed over an existing Eden installation without loss of any configuration. Vice-versa, also the Eden stable version can be installed (back) over the installed PVR (Eden) installation without any harm to move back to the main branch.

For more information about this build and development, please visit the PVR Build section of the XBMC-forum under XBMC PVR-Forum

Configuration & Activation of the PVR

To use the PVR functionalities within XBMC, you have to configure it in two simple steps: activate it and configure the PVR add-on for ARGUS TV properly. If you follow the steps to first configure the PVR add-on and then activate PVR functionality it avoids to quit and re-start XBMC to load all ARGUS TV channels, EPG data etc. But it's of minor importance, just keep in mind to re-start XBMC once, if not.

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.
  • ARGUS TV webserver port: set to 49943 if you used the default settings when installing ARGUS TV
  • Windows User Account: set the username 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.

Activating PVR functionality

System / Settings Live TV and go to the tab General

• Activate "Enabled"
  

• 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 Now you will find in the main menu also 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, the ARGUS TV PVR client is even named to be in alpha stage. Not all functions are yet supported, but absolute stability is given.

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

Troubleshooting

Network and connectivity problems may cause XBMC with activated PVR Support (both, Eden & Frodo) to crash. If you encounter this, e.g. if you're connecting to remote shares or PVR server or reside in an unreliable network, temporarily disable the PVR functionality in System / Settings / Live TV

• 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)

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.

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