Tvheadend

h1. APT Repositories

{{>toc}}

h2. Official Repositories

The official packages are build using Doozer. The repositories are provided by "Doozer":https://doozer.io (at http://apt.tvheadend.org) and Bintray (at https://bintray.com/tvheadend).

h3. Status

(/) 9/4/2018: No reported issues.

h3. Build Types, Versions and Repository Availability

Our repositories differ slightly in structure and package availability.

*Where are packages for my distro/arch?* At the moment Doozer only has support for a limited number of build targets, new ones will be added as soon as possible. Take a look at the 3rd-party repos below or build your own.

| Repository | Version             | Supported Distros and Architectures                                                                                                                                                                                   | Build Type / Repo Component |

| Doozer     | 4.2.6-x (stable)    | ✓ amd64: Debian: Stretch and Jessie, Ubuntu: Bionic, Trusty and Xenial

✓ armhf/arm64: Ubuntu Xenial

*⚠ i386: Debian: Stretch and Jessie, Ubuntu: Trusty and Xenial*

                                                                         | stable |

| Doozer     | 4.3.x (unstable)    | ✓ amd64: Debian: Stretch and Jessie, Ubuntu: Bionic, Trusty and Xenial

✓ armhf/arm64: Ubuntu Xenial

✓ armhf: Raspbian: Jessie and Stretch

*⚠ i386: Debian: Stretch and Jessie, Ubuntu: Trusty and Xenial*

                                                                        | unstable |

| Bintray    | 4.2.6 (release-4.2) | ✓ amd64: Debian: Stretch and Jessie, Ubuntu: Trusty and Xenial

✓ armhf/arm64: Ubuntu Xenial

*⚠ i386: Debian: Stretch and Jessie, Ubuntu: Trusty and Xenial*

                                                                        | release-4.2 |

| Bintray    | 4.2.6-x (stable-4.2)| ✓ amd64: Debian: Stretch and Jessie, Ubuntu: Bionic, Trusty and Xenial

✓ i386: Debian: Stretch and Jessie, Ubuntu: Bionic, Trusty and Xenial

✓ armhf/arm64: Ubuntu Xenial

                                                                        | stable-4.2 |

| Bintray    | 4.3.x (unstable)    | ✓ amd64: Debian: Stretch and Jessie, Ubuntu: Bionic, Trusty and Xenial

✓ i386: Debian: Stretch and Jessie, Ubuntu: Bionic, Trusty and Xenial

✓ armhf/arm64: Ubuntu Xenial

                                                                        | unstable |

✓ = Repository supports that distro and architecture.

⚠ = Repository *doesn't* support certain distros and architectures, and/or packages may have missing features, i.e, transcoding.

h4. Distribution Code-names

| Distro              | Code-name |

| Debian Stretch 9    | stretch  |

| Debian Jessie 8     | jessie   |

| Ubuntu Bionic 18.04 | bionic   |

| Ubuntu Xenial 16.04 | xenial   |

| Ubuntu Trusty 14.04 | trusty   |

| Raspbian Stretch 9  | raspbianstretch |

| Raspbian Jessie 8   | raspbianjessie  |

h3. Usage

h4. 1. 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. Choose build type add the repository

* Replace DISTRO with the distribution's code name - use the +Code-name+ for your distro (as shown in the +Distribution Code-names+ table above).

* Replace REPO-COMPONENT with the desired build type - use the +Build Type / Repo Component+ (as shown in the +Build Types, Versions and Repository Availability+ table above). 

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

* *Pay special attention* to the difference between +stable-4.2+ (on Bintray) and +stable+ (on Doozer).

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>

h4. 3. Refresh 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 - +for bintray+, 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+.

> Example:

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

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