FAQ

General

How do I interact with Tvheadend?

Tvheadend is controlled via a web user interface that runs on an internal HTTP server within Tvheadend. By default the HTTP server listens to port 9981. So if you have installed Tvheadend on your machine you can access the user interface by pointing your browser to http://localhost:9981.

Help! I can’t login to the web user interface.

If you build Tvheadend from source and just execute it, it won’t let anyone in. The rationale behind this is that we think it is bad to have services running with wide open administrative access.

If you start Tvheadend with the ‘-C’ argument. A default user with no user-name or password will be created. Make sure that you later edit this via the Configuration / Access control tab in the web ui.

If you start Tvheadedn with the '--noacl' argument, all Access Control will be removed and you can setup required users via Configuration / Access control tab.

If you installed the Tvheadend debian package you should have been asked for a superuser username + password during the install. This super user account can not be modified from within Tvheadend itself. If you want to change it, you need to reconfigure the Debian package. To do that, execute the following line in a command prompt:

sudo dpkg-reconfigure tvheadend

Why does HTSP use TCP? I thought it was bad to use TCP for realtime sensitive traffic?

HTSP – (Home Tv Streaming Protocol), the protocol used for streaming TV, sending meta information updates and RPC between Tvheadend and a HTSP client uses a transmission scheduler with multiple queues on the Tvheadend side. This means that Tvheadend can measure the available bandwidth between itself and the media player and when congestion happens it’s even capable of dropping less important data (such as B-frames). HTSP has been tested over WAN links and DSL connections with no video or audio artefacts.

Video recorder (DVR / PVR)

Sometime it's called DVR and sometimes PVR, why?

It's really the same thing I just seem to never be able to decide which one of the abbreviations to use. Sorry for the confusion.

I try to transcode the video with FFmpeg but it fails for HD content.

The problem is this:

  • Matroska (.mkv files) does not include a DTS (Decoding Time Stamp) for each frame (or packet)
  • ffmpeg needs a DTS for each packet when remultiplexing video. If a DTS is not available it will try to make one up which it fails to do when the video content is h264. (ie HD video)

I think I found a bug

Please check details here.