Tvheadend

h1. APT Repositories

{{>toc}}

h2. Official Repository

The official deb packages are built using "Doozer":https://doozer.io. Our repositories are provided by Doozer (on apt.tvheadend.org) and "Bintray":https://bintray.com/tvheadend.

h3. Repository Status

(!) 06/21/18 04/30/18 - Bionic builds for stable are currently unavailable due to various issues, failing, see #5091 for updates. You can use "mamarley's unofficial PPA":https://tvheadend.org/projects/tvheadend/wiki/AptRepository#Ubuntu-PPA until resolved.

h3. Build Types and Versions

Please read the following:-

* You may use either repository, or add both _(recommended)_!
* It's advised that you use release or stable, only use unstable if you want bleeding-edge & don't mind breakages.
* If using unstable be sure to install tvheadend-dbg. If reporting crashes with unstable, please include proper [[debugging]] & [[Traces|trace]] information.

+*Bintray*+

| *Build Type* | *Description* | *Version* | *Repo Component* | Notes |
| release | The latest version marked for release | 4.2.6 | release-4.2 | |
| stable | The latest stable code with changes/fixes between releases | 4.2.6-x~githash | stable-4.2 | |
| unstable | This is the current development "bleeding-edge" | 4.3.x | unstable | |

+*Doozer*+

| *Build Type* | *Description* | *Version* | *Repo Component* | Notes |
| stable | The latest stable code with changes/fixes between releases | 4.2.6-x~githash | stable | Jessie, Stretch, Trusty, Xenial only. Bionic not yet available, please use the unofficial PPA. |
| unstable | This is the current development "bleeding-edge" | 4.3.x | unstable | |

h3. Supported Distributions and Architectures

The official repositories support 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 | |
| Bionic Beaver "bionic" (18.04) | - amd64 | *Doozer repository only* |

*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

h4. 1. First install GPG keys:

+*Bintray*+
<pre>
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 379CE192D401AB61
</pre>

+*Doozer (apt.tvheadend.org)*+
<pre>
wget -qO- https://doozer.io/keys/tvheadend/tvheadend/pgp | sudo apt-key add -
</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.

h4. 2. Pick a build type, add the repository accordingly:

+*Bintray*+
<pre>
echo "deb https://dl.bintray.com/tvheadend/deb DISTRO REPO-COMPONENT" | sudo tee /etc/apt/sources.list.d/tvheadend.list
</pre>

> Example:
> <pre>
echo "deb https://dl.bintray.com/tvheadend/deb xenial stable-4.2" | sudo tee /etc/apt/sources.list.d/tvheadend.list
</pre>

+*Doozer*+
<pre>
echo "deb http://apt.tvheadend.org/REPO-COMPONENT DISTRO main" | sudo tee -a /etc/apt/sources.list.d/tvheadend.list
</pre>

> Example:
> <pre>
echo "deb http://apt.tvheadend.org/unstable xenial main" | sudo tee -a /etc/apt/sources.list.d/tvheadend.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.

* *Watch out* for subtle differences though, be sure to check the repository has your desired build type and component.

* *Please pay special attention* to the difference between +stable-4.2+ (on Bintray) and +stable+ (on Doozer), and make sure you use the text in the +Repo Component+ column and not +Build Type+ (in the Build Types and Versions tables).

h4. 3. 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.

* 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.
* 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. 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. 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).