Tvheadend

h1. APT Repositories

{{>toc}}

h2. Official Repository

The official deb packages are built using "Doozer":https://doozer.io and our repository is provided by "Bintray":https://bintray.com/tvheadend.

h3. Build Types and Versions

| *Build Type* | *Description* | *Version*  | *Repo Component* |

| release      | The latest version marked for release | 4.2.5      | release-4.2 |

| stable       | The latest stable code with changes/fixes between releases             | 4.2.5-x~githash    | stable-4.2       |

| unstable     | This is the current development "bleeding-edge" | 4.3.x | unstable |

*It's advised that you use release or stable, only use unstable if you want bleeding-edge & don't mind breakages!*

h3. Supported Distributions and Architectures 

The official repository supports the following distributions and architectures.

| *Distribution*                      | *Architecture*       | *Notes* |

| Debian Jessie "jessie" (8.x)        | - i386

                                        - amd64              |  |

| Debian Stretch "stretch" (9.x)      | - i386

                                        - amd64              |  |

| Ubuntu Xenial "xenial" (16.04)      | - i386

                                        - amd64

                                        - armhf 

                                        - arm64              | armhf/arm64 do not have transcoding support (yet) |

| Trusty "trusty" (14.04)            | - i386

                                       - amd64               |  |

*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. Take a look at the 3rd-party repos below or build your own. 

h3. Usage

First install bintray's GPG key:

<pre>

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

</pre>

> If you see something like the following:

> <pre>Executing: /tmp/apt-key-gpghome666/gpg.1.sh --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 379CE192D401AB61

gpg: failed to start the dirmngr '/usr/bin/dirmngr': No such file or directory

gpg: connecting dirmngr at '/run/user/0/gnupg/d.1234/S.dirmngr' failed: No such file or directory

gpg: keyserver receive failed: No dirmngr

</pre>

> You need to install dirmngr

> <pre>sudo apt-get install dirmngr</pre>

> Once installed add the key again, it should succeed this time.

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

<pre>

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

</pre>

Replace DISTRO with the distribution's code name (as quoted in _Supported Distributions and Architectures_). Replace REPO-COMPONENT with the desired build type.

*Make sure you, use the text in the +Repo Component+ column and not +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>

h3. Help

Please open an issue or join the IRC channel to report problems with the official repository. 

h2. Unofficial Repositories

3rd-party unofficial repositories.

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

h4. Usage

First, pick either the Stable or Unstable build:

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>

h4. Help

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

h3. Raspberry Pi / Raspbian armhf 

Unofficial Raspbian packages are provided by mpmc for both Raspbian Jessie and Stretch. *Before using this repo please read the notes.*

h4. Usage 

To use this repository follow the official usage guide, but change the repository URL from *https://dl.bintray.com/tvheadend/deb* to *https://dl.bintray.com/mpmc/deb* and replace DISTRO with raspbianstretch or raspbianjessie.

h4. Notes

* 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 now a release-4.2 starting with 4.2.4.

* There's no transcoding support, mainly because the Pi isn't powerful enough to do software transcoding and 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.

h4. Help

If you experience issues with this repository contact mpmc on "github":http://github.com/mpmc or send a message on IRC (mpmc in #hts on Freenode).