Tvheadend

h1. h2. Official Apt Repository

The After a significant break from using our official Apt repository repository, due to [[Adam|Adam Sutton]] no longer being actively involved, this has now finally 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 restored. With some slight alterations. There will continue to exist for the foreseeable future (including updates), still be 3 suites, however we'd prefer if people could migrate to the bintray version.

h2. Build type meanings have changed:

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

* release http://apt.tvheadend.org/release - This will contain the latest official / stable release.
* stable http://apt.tvheadend.org/stable - This will contain a nightly build from the latest release branch. It will pick up fixes in prep. for the next release.
* unstable http://apt.tvheadend.org/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. h3. 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. h3. Usage

First install bintray's Before you can use the repository you probably want to import the GPG signing key:

<pre>
curl http://apt.tvheadend.org/repo.gpg.key | sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 379CE192D401AB61
add -
</pre>

Select You will then need to add which release type ever suite you feel is most appropriate, for example if you want to be cautious and add the repository accordingly: have a reliable system:

<pre>
sudo apt-add-repository "http://dl.bintray.com/tvheadend/deb BUILDTYPE" http://apt.tvheadend.org/release
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>

You can easily remove a suite though, so should you suddenly come over all crazy and want to live on the edge:

<pre>
sudo apt-add-repository -r http://apt.tvheadend.org/stable
sudo apt-add-repository http://apt.tvheadend.org/unstable
sudo apt-get update
</pre>

h2. Legacy Official Bintray Apt Repository

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

h3. Build type

This apt.tvheadend.org 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. as a backup (or main) if you wish.

* https://dl.bintray.com/tvheadend/ubuntu master main - This will contain *nightly* builds from the master branch. This _This is equivalent to "unstable" in the official repo. "unstable":http://apt.tvheadend.org/unstable suite on apt.tvheadend.org._
* https://dl.bintray.com/tvheadend/ubuntu unstable main - This will contain *weekly* builds from the master branch. This has no _This is equivalent in to the official repo. "unstable":http://apt.tvheadend.org/unstable suite on apt.tvheadend.org just delayed by a week._
* https://dl.bintray.com/tvheadend/ubuntu testing main - This will contain *nightly* builds from the release/4.x branch. This _This is equivalent to "stable" in the official repo. "stable":http://apt.tvheadend.org/stable suite on apt.tvheadend.org._
* https://dl.bintray.com/tvheadend/ubuntu stable - This will contain the latest stable release. This _This is equivalent to "release" in the official repo. "release":http://apt.tvheadend.org/release suite on apt.tvheadend.org._

h3. Supported Distro's / Platforms

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

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

* Ubuntu
** Trusty (14.04) - amd64
** Utopic (14.10) - amd64
** Vivid (15.04) - amd64

* Reported to work
* ** Debian
** *** Jessie (8.0) - amd64

It may also work on the following:

* Mint Unconfirmed
** Qiuana
(Linux Mint 17) - amd64
** Rebecca or Cinnamon (Mint Linux 17.1) - amd64

* Not supported at all
** Debian
*** Wheezy (7.x)
*** Squeeze (6.x)

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 You will then need to add which release type ever suite you feel is most appropriate, for example if you want to be cautious and add the repository accordingly: have a reliable system:

<pre>
echo deb https://dl.bintray.com/tvheadend/ubuntu stable main | sudo apt-add-repository "http://dl.bintray.com/dreamcat4/ubuntu BUILDTYPE" tee -a /etc/apt/sources.list
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 (nightly) > unstable (weekly) > testing > stable
</pre>

h2. h3. Other

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

---

h2. h3. Help Me!

*Why three two 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]] Adam Sutton 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 Whichever you fancy is the simple answer. You can use the official repository as this is more likely to received continued support. And even if suites from both repositories at the build system should break and [[Adam]] isn't available dreamcat and perexg now know how to feed the bintray repo by alternative means. same time.

*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.
(on apt.tvheadend.org) or master nightly/weekly (on bintray.com) suites.
* If you want to test the latest changes (and don't mind a few minor bugs) that'll shortly be included in become the next latest release choose stable release, use the stable builds.
(on apt.tvheadend.org) or testing (on bintray.com) suites.
* If you just want the least amount of hassle (and bugs) choose the release builds. suites.

*You keep talking about suites, what are they?*
See "this":https://wiki.debian.org/RepositoryFormat#Suite.