Tvheadend

h1. APT Repositories

{{>toc}}



h2. Official Repositories

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

h4. h3. Status

(/) 10/18/2018 - OK, no 9/4/2018: No reported issues.

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

| *Build Type* Repository | *Description* Version | *(Current) Version* Supported Distros and Architectures | *Repo Component* Build Type / Repo Component |
| Stable Doozer | Latest release 4.2.6-x (stable) | ✓ amd64: Debian: Stretch and fixes Jessie, Ubuntu: Bionic, Trusty and Xenial
✓ armhf/arm64: Ubuntu Xenial
*⚠ i386: Debian: Stretch and Jessie, Ubuntu: Trusty and Xenial*
| v4.2.7~githash | stable |
| Development Doozer | Development builds 4.3.x (unstable) | v4.3.*~githash ✓ 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 |

(/) Stable is the +recommended+ choice for most people.
(!) Development is for those who want to help develop | Bintray | 4.2.6 (release-4.2) | ✓ amd64: Debian: Stretch and test the latest code.

h3. Supported Distros Jessie, Ubuntu: Trusty and Architectures

Xenial
✓ armhf/arm64: Ubuntu Xenial
*⚠ i386: Debian: Stretch and Jessie, Ubuntu: Trusty and Xenial*
| *Distro* release-4.2 | *Code-name*
| *Architectures* Bintray | *Notes* 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 | amd64, i386 | None |
| Debian Jessie 8 | jessie | amd64, i386 | See footnote 1[1] |
| Ubuntu Bionic 18.04 | bionic | amd64, i386 | None |
| Ubuntu Xenial 16.04 | xenial | amd64, i386, arm64 | See footnote 1[1] - applies to arm64 only |
| Ubuntu Trusty 14.04 | trusty | amd64, i386 | None |
| Raspbian Stretch 9 | raspbian-stretch raspbianstretch | armhf | See footnote 1[1] |
| Raspbian Jessie 8 | raspbian-jessie raspbianjessie | armhf | See footnote 1[1] |

fn1. Transcoding support is unavailable on these distros.

h3. Usage

Here are some copy/paste examples on how to use the repo that should work for most[2].

h4. 1. Install Required Packages and add the Repository PGP key GPG keys

Bintray:
<pre>
sudo apt-get -y install coreutils wget apt-transport-https lsb-release ca-certificates apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 379CE192D401AB61
</pre>

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

fn2. We assume you have sudo installed. ---

If not, and you're root, you can omit sudo, otherwise please ask your administrator to.. <pre>apt-get 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 sudo</pre> and <pre>usermod -aG sudo <your account name></pre> dirmngr:

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

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

h4. 2. Create/Add Choose build type add the Sources List repository

*Raspbian users (and anyone else who can't install/use lsb-release) please see * Replace DISTRO with the third footnote[3]*.

Stable: 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>
sh -c 'echo echo "deb https://apt.tvheadend.org/stable $(lsb_release -sc) main" https://dl.bintray.com/tvheadend/deb DISTRO REPO-COMPONENT" | sudo tee -a /etc/apt/sources.list.d/tvheadend.list' /etc/apt/sources.list.d/tvheadend.list
</pre>

Unstable: > Example:
> <pre>
sh -c 'echo echo "deb https://apt.tvheadend.org/unstable $(lsb_release -sc) main" https://dl.bintray.com/tvheadend/deb xenial stable-4.2" | sudo tee -a /etc/apt/sources.list.d/tvheadend.list' /etc/apt/sources.list.d/tvheadend.list
</pre>

fn3. Unfortunately you won't be able to use the command, at least not in the way it's shown, you need to replace " $(lsb_release -sc)" with "raspbian-stretch", "raspbian-jessie" or your distros code-name.

fn3001. Examples..
> <pre>echo Doozer
<pre>
echo "deb http://apt.tvheadend.org/stable raspbian-jessie http://apt.tvheadend.org/REPO-COMPONENT DISTRO main" | sudo tee -a /etc/apt/sources.list.d/tvheadend.list</pre>
/etc/apt/sources.list.d/tvheadend.list
</pre>

> <pre>echo Example:
> <pre>
echo "deb http://apt.tvheadend.org/stable raspbian-stretch http://apt.tvheadend.org/unstable xenial main" | sudo tee -a /etc/apt/sources.list.d/tvheadend.list</pre>

fn3002. *Tip:* If you want to use unstable, simply replace _stable_ with _unstable_.

/etc/apt/sources.list.d/tvheadend.list
</pre>

h4. 3. Update Sources Refresh packages and Install install

<pre>
sudo apt-get update
sudo apt-get install tvheadend
</pre>

> *Tip:* On some installs (generally fresh ones) Note: if you might be asked to enter some details. If you'd like to reconfigure these details later, install more than one suite you can run.. <pre>sudo dpkg-reconfigure tvheadend</pre> and afterwards.. <pre>sudo service tvheadend restart</pre> :)

Job done!

h3. Help

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

---

h2. Third-party

Third-party repositories are provided as-is and supported by the person who manages them, we cannot guarantee that we'll be able to help with issues relating to the use of these packages/repositories. The older official Bintray is exempt from this (Yes we know it's not technically third party ;)).

In any case we'll try our best to help, or point you to where you can will only ever get some!

h3. (Older) Official Bintray

This is our older official Bintray repository, packages are built using Doozer, from the repository itself is provided by "Bintray":https://bintray.com via https://bintray.com/tvheadend.

h4. What Happened to one holding the Bintray Repository?

Unfortunately due to rate-limiting we've decided to phase-out (SLOWLY) most recent version number, so the use order of Bintray. *Don't worry the repository won't be disappearing[4], it just won't be updated as often :(.*

If you priority would like to use old instructions they can be viewed "here":https://tvheadend.org/projects/tvheadend/wiki/AptRepository/116 :) be:

fn4. mpmc's third-party Bintray repository will still be updated regularly, so Raspbian users don't panic - see the link above for usage. :) However, it's now recommended that you use the official repo :) <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. Status

(!) 10/18/2018 - Please see "here (stable)":https://launchpad.net/~mamarley/+archive/ubuntu/tvheadend-git-stable and "here (unstable)":https://launchpad.net/~mamarley/+archive/ubuntu/tvheadend-git for PPA status.

h4. Usage

*1. Pick a Build Type* 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>

*2. Then, for both:

Update Sources*

your packages:
<pre>sudo apt update</pre>

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