Tvheadend

h1. APT Repositories

{{>toc}}



h2. Official Repository

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

h4. h3. Repository Status

(/) 10/18/2018 (!) 10/17/2018:
Unfortunately Bintray have (once again) blocked us - OK, no reported issues. the reason being is that our unstable packages are not classed as release artefacts - we're working on a more concrete solution! For the moment please download the packages from "here":https://doozer.io/tvheadend/tvheadend.

h3. Build Types and Versions

Please read the following:-

* You can add more than one repository _(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* | *(Current) Version* *Version* | *Repo Component* | Notes |
| Stable release | Latest The latest version marked for release and fixes | v4.2.7~githash 4.2.6 | stable release-4.2 | |
| Development stable | Development builds The latest stable code with changes/fixes between releases | v4.3.*~githash 4.2.6-x~githash | stable-4.2 | |
| unstable |

(/) Stable This is the +recommended+ choice for most people.
(!) Development is for those who want to help develop and test the latest code. current development "bleeding-edge" | 4.3.x | unstable | |

*But, where's release?!* +*Doozer*+

We've decided not to offer "frozen" builds anymore, this is so that people get fixes much sooner. Those that are currently using release can modify their apt sources to stable, or continue as they are now, and move when they feel ready.

h3. Supported Distros and Architectures

| *Distro* *Build Type* | *Code-name* *Description* | *Architectures* *Version* | *Notes* *Repo Component* | Notes |
| Debian Stretch 9 stable | The latest stable code with changes/fixes between releases | 4.2.6-x~githash | stretch stable | amd64, i386 Jessie, Stretch, Trusty, Xenial and Bionic only. | None |
| Debian Jessie 8 unstable | jessie This is the current development "bleeding-edge" | amd64, i386 4.3.x | See footnote 1[1] unstable |
| Ubuntu Bionic 18.04

h3. Supported Distributions and Architectures

The official repositories support the following distributions and architectures.

| bionic *Distribution* | amd64, i386 *Architecture* | None *Notes* |
| Ubuntu Xenial 16.04 Debian Jessie "jessie" (8.x) | xenial - i386
- amd64 | amd64, i386, arm64 | See footnote 1[1] - applies to arm64 only |
| Ubuntu Trusty 14.04 Debian Stretch "stretch" (9.x) | trusty | amd64, - i386
- amd64 | None |
| Raspbian Stretch 9 Ubuntu Xenial "xenial" (16.04) | raspbian-stretch | - i386
- amd64
- armhf
- arm64 | See footnote 1[1] - armhf/arm64 do not have transcoding support (yet).
- Ubuntu arm builds are only available from Doozer. |
| Raspbian Jessie 8 Trusty "trusty" (14.04) | raspbian-jessie - i386
- amd64 | | armhf
| See footnote 1[1] Bionic Beaver "bionic" (18.04) |

fn1. Transcoding support is unavailable on these distros.

- amd64
- i386 | |

h3. Usage

Here *Where are some copy/paste examples on how to use the repo that should work builds for most[2]. 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. 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; 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 the third footnote[3]*.

Stable: +*Bintray*+
<pre>
sudo 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>
sudo 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..
+*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>

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

* 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 want to use unstable, simply replace _stable_ with _unstable_.

-

the text in the +Repo Component+ column and not +Build Type+ (in the Build Types and Versions tables).

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 - sorry about that.* :(

You can continue to use Bintray if you like, old instructions can be viewed "here":https://tvheadend.org/projects/tvheadend/wiki/AptRepository/116. priority would be:

*Tip:* You can use both apt.tvheadend.org and bintray.com/tvheadend <pre>
unstable > stable-4.2 > stable
</pre>

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.

-

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 and so on for the amd64, arm64, armhf, i386 and ppc64el architectures.

h4. Status

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