tvheadend

8837853a-ls288

tvheadend works as a proxy server: is a TV streaming server and recorder for Linux, FreeBSD and Android supporting DVB-S, DVB-S2, DVB-C, DVB-T, ATSC, ISDB-T, IPTV, SAT>IP and HDHomeRun as input sources. Tvheadend offers the HTTP (VLC, MPlayer), HTSP (Kodi, Movian) and SAT>IP streaming. Multiple EPG sources are supported (over-the-air DVB and ATSC including OpenTV DVB extensions, XMLTV, PyXML).

Media Tools

docker pull lscr.io/linuxserver/tvheadend:latest

Quick start

Generated from the image's own configuration. Replace the /path/to folders with real paths on your host.

Include optional settings

---
services:
  tvheadend:
    image: lscr.io/linuxserver/tvheadend:latest
    container_name: tvheadend
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - RUN_OPTS= # optional
    volumes:
      - /path/to/tvheadend/data:/config
      - /path/to/recordings:/recordings
    ports:
      - 9981:9981
      - 9982:9982
    devices:
      - /dev/dri:/dev/dri # optional
      - /dev/dvb:/dev/dvb # optional
    restart: unless-stopped

Parameters

Ports
Port	Function	Required
9981:9981	WebUI	required
9982:9982	HTSP server port.	required

Environment variables
Variable	Function	Required
PUID=1000	User ID	required
PGID=1000	Group ID	required
TZ=Etc/UTC	Timezone	required
RUN_OPTS=	Optionally specify additional arguments to be passed. See Additional runtime parameters.	optional

Volumes
Path	Function	Required
/config	Where TVHeadend show store it's config files.	required
/recordings	Where you want the PVR to store recordings.	required

Devices
Device	Function	Required
/dev/dri	Only needed if you want to use your AMD/Intel GPU for hardware accelerated video encoding (vaapi).	optional
/dev/dvb	Only needed if you want to pass through a DVB card to the container. If you use IPTV or HDHomeRun you can leave it out.	optional

Architectures

Pulling :latest picks the right one for your host automatically.

x86_64amd64-latest
arm64arm64v8-latest

Changelog

25 Jun 2024
Rebase to Alpine 3.20.
20 Mar 2024
Rebase to Alpine 3.19.
16 Oct 2023
Add mesa-va-gallium package for AMD transcoding.

Writing

Posts about tvheadend

17 Sep 20174 min read

How To: Setup Containers on QNAP

The aim of this guide will be to show new users of our containers how to get started on the QNAP platform. I will cover how to go about setting up the user and permissions as well…

19 Feb 20179 min read

How to set up Tvheadend with your DVB-T2 receiver

Tvheadend is a comprehensive and full-featured piece of software that readily transforms your perception of TV and how it is accessed. However, this comprehensiveness comes at a…

5 Feb 20173 min read

Live TV with the TBS 6281SE DVB-T2 Tuner

The next step in the long line of things I've been doing to my HP ProLiant Gen8 Microserver was to give it some TV capability. Since moving house last year, the living room has…

Browse all

tautulli

v2.18.2-ls249

tautulli is a python based web application for monitoring, analytics and notifications for Plex Media Server.

2.3M245arm64

ffmpeg

9.0.2-cli-ls87

A complete, cross-platform solution to record, convert and stream audio and video.

194K209

oscam

11968-ls27

oscam is an Open Source Conditional Access Module software used for descrambling DVB transmissions using smart cards. It's both a server and a client.

23.9K54arm64

webgrabplus

5.6.1-ls307

webgrabplus is a multi-site incremental xmltv epg grabber. It collects tv-program guide data from selected tvguide sites for your favourite channels.

11.2K32arm64