Tvheadend

h1. Official APT Repository

h2. We are aware issues with the Bintray repository as of 08/24/2017. Please don't open tickets or forum threads. For updates/to complain, see #4547. Hopefully it will be resolved soon!

* 08/25/2017 - Still waiting for a reply from Bintray, given it's near the weekend (in many parts of the world) we more than likely won't hear anything for a few days.

The repository is provided by "Bintray":https://bintray.com/tvheadend containing packages built by "Doozer.io":https://doozer.io/tvheadend/tvheadend. 

*Please note that with the changes to the build system, the list of supported distros has changed.* Please check the _Supported Distributions / Platforms_ list below, if your distribution isn't listed there may be an older version available, new build targets *will* be added as soon as possible.

h2. 4.2

This is the current-stable release.

h3. Supported Distributions / Platforms

* Debian

** Jessie "jessie" (8.x) - i386 / amd64

** Jessie "stretch" (9.x) - i386 / amd64

* Ubuntu

** Xenial "xenial" (16.04.x) - i386 / amd64 / armhf / arm64.

** Trusty "trusty" (14.04.x) - i386 / amd64 - see note 1.

** Precise "precise" (12.04.x) - i386 / amd64 - see note 2.

If you're looking for Raspbian "raspbianjessie/raspbianstretch" packages, please see the Help! below.

Notes:

# The armhf and arm64 builds do not have transcoding built in at the moment.

# The i386 builds for precise do not have transcoding built in, and seeing as this version of Ubuntu is now EOL it will eventually be removed.

h4. Build types

* release-4.2 - The latest version marked as release (like 4.2.2). This is currently 4.2.3.

* stable-4.2 - The latest official / stable code including changes between releases (like 4.2.2-10~gHASH).

h2. 4.0

This is the old-stable release. Please note, there will be no further updates to this version.

h3. Supported Distributions / Platforms

* Debian

** Jessie "jessie" (8.x) - i386 / amd64

* Ubuntu

** Xenial "xenial" (16.04.x) - i386 / amd64

** Wily Werewolf "wily" (15.10.x) - i386 / amd64

** Trusty (14.04.x) "trusty" - i386 / amd64

h4. Build types

There is currently only one build type for 4.0.

* stable - An old-stable build from the 4.0 release branch.

h2. Development/Unstable

This is the current development "bleeding-edge" release. It contains builds from the development (master) branch on "Github":https://github.com/tvheadend/tvheadend. *Only use this build if you want bleeding-edge & don't mind breakages!*

h3. Supported Distributions / Platforms

* Debian

** Jessie "jessie" (8.x) - i386 / amd64

** Jessie "stretch" (9.x) - i386 / amd64

* Ubuntu

** Xenial "xenial" (16.04.x) - i386 / amd64 / armhf / arm64 - see note 1 + 2.

** Trusty "trusty" (14.04.x) - i386 / amd64 - see note 1.

Notes:

# Due to issues with building x264, i386 builds have limited transcoding support.

# armhf and arm64 builds do not have transcoding built in at the moment.

h4. Build types

There is currently only one build type for unstable.

* unstable - This will contain a nightly build from the development branch (master)

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 build type you want and add the repository accordingly:

<pre>

echo "deb https://dl.bintray.com/tvheadend/deb DISTRO BUILDTYPE" | sudo tee -a /etc/apt/sources.list

</pre>

Replace DISTRO with the distribution's code name (as quoted in the _Supported Distro's / Platforms_ list). 

Replace BUILDTYPE with the desired build type.

> Example:

> <pre>

echo "deb https://dl.bintray.com/tvheadend/deb xenial stable-4.2" | sudo tee -a /etc/apt/sources.list

</pre>

Refresh the available packages and install:

<pre>

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-4.2 > stable

</pre>

h2. Help!

*Where are the builds for my distro/arch?*

At the moment the Doozer build system only has support for a limited number of build targets. New targets will be added as soon as possible. If you're impatient you may build your own packages. 

*What happened to nightly builds?*

They're no longer being provided, packages are now built on-the-fly once a commit to the branch has been pushed.

*Are there packages for Raspbian?*

Yes! However it's not official, but pretty close. To use it, you simply follow the usage instructions above but change the apt source URL..

* From 

<pre>

deb https://dl.bintray.com/tvheadend/deb

</pre>

* To 

<pre>

deb https://dl.bintray.com/mpmc/deb

</pre>

> Example:

> <pre>echo "deb https://dl.bintray.com/mpmc/deb raspbianstretch stable-4.2" | sudo tee -a /etc/apt/sources.list</pre>

Please read the following:

* These builds are done *manually* and may lag behind, however I'll do my best to keep them updated until the official repo is able to provide the packages.

* Only *stable-4.2* and *unstable* builds are available. *There is no release-4.2 build*.

* There is no transcoding support, mainly because the Pi isn't powerful enough to do software transcoding & hardware transcoding is not yet available. 

* There is no changes to the code whatsoever for these builds.

* Make sure to enter the distro as "raspbianjessie"/"raspbianstretch" and not "jessie"/"stretch".

* If you experience an issue please contact me on "github":http://github.com/mpmc, or send me a message on IRC - I idle as mpmc in #hts on Freenode.

*Is there an Ubuntu PPA?*

Unofficial PPAs are provided by Michael Marley that provide packages for Artful, Zesty, Yakkety, and Xenial for the amd64, arm64, armhf, i386 and ppc64el architectures.

First, pick either the Stable or Unstable builds:

* For the Stable PPA containing daily builds from the latest stable branch:

<pre>sudo apt-add-repository ppa:mamarley/tvheadend-git-stable</pre>

* For the Unstable PPA containing daily builds from master:

<pre>sudo apt-add-repository ppa:mamarley/tvheadend-git</pre>

Then, for both:

* Update your packages:

<pre>sudo apt update</pre>

* Install:

<pre>sudo apt install tvheadend</pre>

If you experience issues with this PPA please contact Michael on IRC (mamarley in #hts on Freenode) or "Launchpad":https://launchpad.net/~mamarley.