tvheadend(1)tvheadend(1)NAMEtvheadend - Advanced TV streaming server/relay
SYNOPSIStvheadend [OPTIONS]
DESCRIPTION
Tvheadend is a streaming server/relay supporing a variety of sources
and multiple output formats. It is primarily inteded to be used in
together with the Showtime Media player.
OPTIONS
All arguments are optional.
-f Fork and become a background process (deamon). Default no.
-u username
Run as user username. Only applicable if daemonizing. Default is
to use the uid of 1 (daemon on most systems).
-g groupname
Run as group groupname. Only applicable if daemonizing. Default
is to use the 'video' group. If the 'video' group does not
exist, gid 1 (daemon) will be used.
-C If no useraccount exist then create one with no username and no
password. Use with care as it will allow world-wide administra‐
tive access to your Tvheadend installation until you edit the
access-control from within the Tvheadend UI.
LOGGING
All activity inside tvheadend is logged to syslog using log facility
LOG_DAEMON.
SETUP
Access to video adapters
In order for Tvheadend to control the video adapters on the system it
must be granted access to those devices. Most systems have a 'video'
group with write access to the video adapter devices. When Tvheadend is
started as a daemon it will automatcially change its primary group to
'video' in order to access these groups. If your system is configured
in a different way you can either change the group membership of the
video adapters (/dev/dvb, etc) or reconfigure the Tvheadend startup
parameters. This is most likely the behaviour if you have installed
Tvheadend from a distribution package.
If Tvheadend is started without the '-f' argument it will not daemonize
nor change its primary userid/groupid. Rather it will run with the per‐
missions granted to the user executing the binary. If that's the case
you must make sure the current user is granted with access to the video
devices.
Configuration
All configuration in Tvheadend is maintained via its embedded web
server running on port 9981. Just point your browser to:
http://hostname:9981/
By default everyone (also from remote hosts) is allowed full access to
all features / settings in the web user interface. If this is the first
time you setup Tvheadend you are most encouraged to enter the web user
interface, selected the 'Configuration' + 'Access Control' tab and make
reasonable changes. Futher help / documentationcan be obtained inside
the web interface.
Settings
Settings are stored in the current users home directory. Thus, if
Tvheadend is run as a system daemon a dedicated user needs to be cre‐
ated and Tvheadend should be launched with the '-u' argument. Also
notice that XMLTV will read store cache and configuration from the user
home directory.
If daemonizing, tvheadend will writes it pid in /var/run/tvheadend.pid
AUTHOR
Tvheadend and this man page is maintained by Andreas Oeman
(andreas a tvheadend d org)
You may also visit #hts at irc.freenode.net
SEE ALSO
https://tvheadend.org
tvheadend(1)
