TODO: this needs to be updated.

This article describes how to build Tvheadend from source

Make sure you have avahi and git installed, these are required to build Tvheadend

# emerge -av avahi git

now create the following directories

mkdir -p /opt/tvheadend/src

now you need to fetch the Tvheadend source code using git

git clone /opt/tvheadend/src/

now you need to prepare the Tvheadend source code

cd /opt/tvheadend/src
./configure --prefix=/opt/tvheadend 

if all went well you can compile the Tvheadend source code


If the source is compiled with no errors you can install the compiled source

make install

if you want you can also create this init script to start Tvheadend at boot time


# Copyright 1999-2010 Gentoo Foundation
# Distributed under the terms of the GNU General Public License v2
# $Header:

depend() {
        need net

start() {
        ebegin "Starting tvheadend" 
        start-stop-daemon --start \
                --user ${TVHUSER} \
                --exec ${TVHBIN} -- -C -f
        eend $?

stop() {
        ebegin "Stopping tvheadend" 
        start-stop-daemon --stop --quiet --name ${TVHNAME} --signal 2
        eend $?


# /etc/conf.d/tvheadend: config file for /etc/init.d/tvheadend


now set /etc/init.d/tvheadend as executable

chmod +x /etc/init.d/tvheadend

Create the tvheadend and add tvheadend to the group video

groupadd tvheadend
useradd -d /opt/tvheadend/home/ -g tvheadend -s /sbin/nologin -m tvheadend
gpasswd -a tvheadend video

now you can try to start Tvheadend

/etc/init.d/tvheadend start

if this works fine you can also add it to runlevel default so Tvheadend starts automatically

rc-update add tvheadend default

now you can go to http://hostname:9981/ and start using/configuring Tvheadend