Tvheadend

h1. Official Apt Repository

The official Apt repository has now been moved to https://bintray.com

Unfortunately the migration required a change to the repository structure that makes it's layout incompatible with the existing http://apt.tvheadend.org repository, therefore we have not tried to map the old URLs to the new repository. Instead the old repository will continue to exist for the foreseeable future (including updates), however we'd prefer if people could migrate to the bintray version. 

h2. Build type

As before there are 3 standard build types (though I've added a 4th to keep old users happy):

* release  - This will contain the latest official / stable release.

* stable   - This will contain a nightly build from the latest release branch. It will pick up fixes in prep. for the next release.

* unstable - This will contain a nightly build from the development branch (master). It will contain the bleeding edge, but could be potentially unstable.

* obsolete - This contains a build of the last release from the 3.4 branch, it will receive no further updates.

h2. Supported Distro's / Platforms

* Ubuntu

** Precise (12.04) - i386 / amd64

** Trusty (14.04) - i386 / amd64

** Vivid (15.04) - i386 / amd64

* Debian

** Wheezy - i386 / amd64

** Jessie - i386 / amd64 / armel

* Raspbian (ARMv6)

** Wheezy - armhf

** Jessie - armhf

Note: it's the intention to include Sid as well, unfortunately there have been some hiccups getting this working.

h2. Usage

First install bintray's GPG key:

<pre>

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 379CE192D401AB61 

</pre>

Select which release type you want and add the repository accordingly:

<pre>

sudo apt-add-repository "http://dl.bintray.com/tvheadend/deb DISTRO BUILDTYPE"

sudo apt-get update

sudo apt-get install tvheadend

</pre>

Note: if you install more than one suite you will only ever get packages from the one holding the most recent version number, so the order of priority would be:

<pre>

unstable > stable > release > obsolete

</pre>

h2. Legacy Bintray Apt Repository

If you're still using the old http://bintray.com/dreamcat4 repository do not panic it's +still+ being supported for the forseeable future.

h3. Build type

This repository also provides 4 possible components. However they are slightly different to those in the official repository and some of the names have different meanings.

* master   - This will contain *nightly* builds from the master branch. This is equivalent to "unstable" in the official repo.

* unstable - This will contain *weekly* builds from the master branch. This has no equivalent in the official repo.

* testing  - This will contain *nightly* builds from the release/4.x branch. This is equivalent to "stable" in the official repo.

* stable   - This will contain the latest stable release. This is equivalent to "release" in the official repo.

h3. Supported Distro's / Platforms

+This repository only officially supports builds for one platform Ubuntu Trusty amd64.+

However the builds are known to work on a variety of other amd64 distributions:

* Ubuntu

** Trusty

** Utopic

** Vivid

* Debian

** Jessie

It may also work on the following:

* Mint

** Qiuana

** Rebecca or Cinnamon

h3. Usage

Before you can use the suites you probably want to import the GPG signing key:

<pre>

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 379CE192D401AB61 

</pre>

Select which release type you want and add the repository accordingly:

<pre>

sudo apt-add-repository "http://dl.bintray.com/dreamcat4/ubuntu BUILDTYPE"

sudo apt-get update

sudo apt-get install tvheadend

</pre>

Note: if you install more than one suite you will only ever get packages from the one holding the most recent version number, so the order of priority would be:

<pre>

master > unstable > testing > stable

</pre>

h2. Other 

If you require builds that are not currently supported see https://github.com/tvheadend/tvheadend-build#looking-for-tvheadend-builds

---

h2. Help Me!

*Why three repositories?*

There was a change in the naming of Tvheadend packages which caused the automated build scripts (that placed the latest builds on apt.tvheadend.org) to break and only [[Adam]] knew how to fix it unfortunately he was unavailable, and thus thanks to dreamcat the bintray repository was born!

Having resurrected the autobuild system, [[Adam]] then saw the benefits of bintray and decided to integrate the old build system (that fed apt.tvheadend.org) to also post to bintray.com. So quickly decided to migrate everything to bintray, but due to the nature of builds being provided it would not be compatible with either of the existing repo's.

*So which repository do I use?*

It's preferred that you use the official repository as this is more likely to received continued support. And even if the build system should break and [[Adam]] isn't available dreamcat and perexg now know how to feed the bintray repo by alternative means.

*Stable, unstable/master, testing or release?*

* If you want the latest and greatest features and don't mind bugs or crashes choose the unstable builds. It's not recommended this be used for production systems.

* If you want to test the latest changes (and don't mind a few minor bugs) that'll shortly be included in the next stable release, use the stable builds.

* If you just want the least amount of hassle (and bugs) choose the release builds.