Tvheadend

h1. Official APT Repositories

{{>toc}}

h2. Official Repository

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

*Please note that with the changes to the build system, the list of supported distros has changed.* Please check the _Supported Distributions / Platforms_ list below, if your distribution isn't listed there may be an older version available, new build targets *will* be added as soon as possible.

h2. 4.2

This is the current-stable release.

h3. Build Types and Versions Supported Distributions / Platforms

| *Build Type* | *Description* | *Version* | *Repo Component* | * Debian
| release | ** Jessie "jessie" (8.x) - i386 / amd64
** Jessie "stretch" (9.x) - i386 / amd64

* Ubuntu
** Xenial "xenial" (16.04.x) - i386 / amd64 / armhf / arm64.
** Trusty "trusty" (14.04.x) - i386 / amd64 - see note 1.

If you're looking for Raspbian "raspbianjessie/raspbianstretch" packages, please see the Help! below.

Notes:
# The armhf and arm64 builds do not have transcoding built in at the moment.

h4. Build types

* release-4.2 - The latest version marked for as release | 4.2.3 | release-4.2 | (like 4.2.2). This is currently 4.2.3.
| stable | * stable-4.2 - The latest official / stable code with changes/fixes including changes between releases | 4.2.3-x~githash | stable-4.2 | (like 4.2.2-10~gHASH).

h2. 4.0

This is the old-stable release. Please note, there will be no further updates to this version.

h3. Supported Distributions / Platforms

* Debian
| unstable | ** Jessie "jessie" (8.x) - i386 / amd64

* Ubuntu
** Xenial "xenial" (16.04.x) - i386 / amd64
** Wily Werewolf "wily" (15.10.x) - i386 / amd64
** Trusty (14.04.x) "trusty" - i386 / amd64

h4. Build types

There is currently only one build type for 4.0.

* stable - An old-stable build from the 4.0 release branch.

h2. Development/Unstable

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

*It's advised that you release. It contains builds from the development (master) branch on "Github":https://github.com/tvheadend/tvheadend. *Only use release or stable, only use unstable this build if you want bleeding-edge & don't mind breakages!*

h3. Supported Distributions and Architectures

The official repository supports the following distributions and architectures. / Platforms

| *Distribution* | *Architecture* | *Notes* | * Debian
| Debian ** Jessie "jessie" (8.x) | - i386
- / amd64 | |
| Debian Stretch ** Jessie "stretch" (9.x) | - i386
- / amd64 | |

* Ubuntu
| Ubuntu ** Xenial "xenial" (16.04) | (16.04.x) - i386
- / amd64
- / armhf
/ arm64 - arm64 | armhf/arm64 do not have transcoding support (yet) | see note 1 + 2.
| ** Trusty "trusty" (14.04) | (14.04.x) - i386
/ amd64 - amd64 | | see note 1.

*Where are the Notes:
# Due to issues with building x264, i386 builds for my distro/arch?* have limited transcoding support.
At # armhf and arm64 builds do not have transcoding built in at the moment the Doozer moment.

h4. Build types

There is currently only one build system only has support type for unstable.

* unstable - This will contain a limited number of nightly build targets. New targets will be added as soon as possible. Take a look at from the 3rd-party repos below or build your own.

h3. development branch (master)

h2. Usage

First install bintray's GPG key:

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

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

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

Replace DISTRO with the distribution's code name (as quoted in the _Supported Distributions and Architectures_). Distro's / Platforms_ list).
Replace REPO-COMPONENT BUILDTYPE with the desired 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 Help!

3rd-party unofficial repositories.

h3. Ubuntu PPA

Unofficial PPAs *Where 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: for my distro/arch?*
<pre>sudo apt-add-repository ppa:mamarley/tvheadend-git-stable</pre>

For At the Unstable PPA containing daily builds from master:
<pre>sudo apt-add-repository ppa:mamarley/tvheadend-git</pre>

Then, moment the Doozer build system only has support for both:

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

Install:
<pre>sudo apt install tvheadend</pre>

h4. Help

a limited number of build targets. New targets will be added as soon as possible. If you're impatient 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 may build your own packages.

Unofficial Raspbian *What happened to nightly builds?*
They're no longer being provided, packages are provided by mpmc for both Raspbian Jessie and Stretch. *Before using this repo please read now built on-the-fly once a commit to the notes.* branch has been pushed.

h4. Usage

*Are there packages for Raspbian?*
Yes! However it's not official, but pretty close. To use this repository it, you simply follow the official usage guide, instructions above but change the repository URL from *https://dl.bintray.com/tvheadend/deb* to *https://dl.bintray.com/mpmc/deb* and replace DISTRO with apt source URL..
* From
<pre>
deb https://dl.bintray.com/tvheadend/deb
</pre>

* To
<pre>
deb https://dl.bintray.com/mpmc/deb
</pre>
> Example:
> <pre>echo "deb https://dl.bintray.com/mpmc/deb raspbianstretch or raspbianjessie. stable-4.2" | sudo tee -a /etc/apt/sources.list</pre>

h4. Notes

Please read the following:
* 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's There is 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 "raspbianjessie"/"raspbianstretch" and not jessie/stretch.

h4. Help

"jessie"/"stretch".
* If you experience issues with this repository an issue please contact mpmc me on "github":http://github.com/mpmc "github":http://github.com/mpmc, or send me a message on IRC (mpmc - I idle as mpmc in #hts on Freenode). Freenode.

*Is there an 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.

First, pick either the Stable or Unstable builds:

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

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