139 lines
4.7 KiB
Groff
139 lines
4.7 KiB
Groff
.TH "tvheadend" 1
|
|
.SH NAME
|
|
tvheadend \ - Advanced TV streaming server/relay
|
|
.SH SYNOPSIS
|
|
.B tvheadend
|
|
[\fIOPTIONS\fR]
|
|
.SH DESCRIPTION
|
|
.B 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
|
|
.B Showtime
|
|
Media player.
|
|
.SH OPTIONS
|
|
All arguments are optional.
|
|
.TP
|
|
\fB\-v\fR, \fB\-\-version\fR
|
|
Show version information.
|
|
.TP
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
Show built-in help information (may be more up to date).
|
|
.TP
|
|
\fB\-c\fR, \fB\-\-config\fR
|
|
Specify an alternate config path; the default is \fI${HOME}/.hts\fR
|
|
.TP
|
|
\fB\-f
|
|
Fork and become a background process (deamon). Default no.
|
|
.TP
|
|
\fB\-u\fR \fIusername\fR, \fB\-\-user\fR \fIusername\fR
|
|
Run as user \fIusername\fR. Only applicable if daemonizing. Default is to
|
|
use the uid of 1 (daemon on most systems).
|
|
.TP
|
|
\fB\-g\fR \fIgroupname\fR, \fB\-\-group \fR\fIgroupname\fR
|
|
Run as group \fR\fIgroupname\fR. Only applicable if daemonizing. Default is to use the 'video' group. If the 'video' group does not exist, gid 1 (daemon) will be used.
|
|
.TP
|
|
\fB\-p\fR \fIpidpath\fR, \fB\-\-pid \fR\fIpidpath\fR
|
|
Specify alternative PID path file (default /var/run/tvheadend.pid).
|
|
.TP
|
|
\fB\-C\fR, \fB\-\-firstrun\fR
|
|
If no useraccount exist then create one with no username and no
|
|
password. Use with care as it will allow world-wide administrative
|
|
access to your Tvheadend installation until you edit the
|
|
access-control from within the Tvheadend UI.
|
|
.TP
|
|
\fB\-a\fR, \fB\-\-adapters\fR
|
|
Only use specified DVB adapters (comma separated).
|
|
.TP
|
|
\fB\-6\fR, \fB\-\-ipv6\fR
|
|
Listen on IPv6.
|
|
.TP
|
|
\fB\-b\fR \fIaddress\fR, \fB\-\-bindaddr\fR \fIaddress\fR
|
|
Specify an interface IP address on which incoming HTTP and HTSP connections
|
|
will be accepted. By default, connections are accepted on all interfaces.
|
|
.TP
|
|
\fB\-\-http_port
|
|
Specify alternative http port (default 9881).
|
|
.TP
|
|
\fB\-\-http_root
|
|
Specify alternative http webroot.
|
|
.TP
|
|
\fB\-\-htsp_port
|
|
Specify alternative htsp port (default 9882).
|
|
.TP
|
|
\fB\-\-htsp_port2
|
|
Specify extra htsp port.
|
|
.TP
|
|
\fB\-d\fR, \fB\-\-debug\fR
|
|
Enable all debug.
|
|
.TP
|
|
\fB\-s\fR, \fB\-\-syslog\fR
|
|
Enable debug to syslog.
|
|
.TP
|
|
\fB\-\-uidebug
|
|
Enable web UI debug.
|
|
.TP
|
|
\fB\-l\fR, \fB\-\-log\fR
|
|
Log to file.
|
|
.TP
|
|
\fB\-A\fR, \fB\-\-abort\fR
|
|
Immediately abort on startup (for debug).
|
|
.TP
|
|
\fB\-\-noacl
|
|
Do not perform any access control checking.
|
|
.TP
|
|
\fB\-R\fR, \fB\-\-dvbraw\fR
|
|
Use rawts file to create virtual adapter.
|
|
.TP
|
|
\fB\-r\fR, \fB\-\-rawts\fR
|
|
Use rawts file to generate virtual services.
|
|
.TP
|
|
\fB\-j\fR, \fB\-\-join\fR
|
|
Subscribe to a service permanently.
|
|
.SH "LOGGING"
|
|
All activity inside tvheadend is logged to syslog using log facility
|
|
\fBLOG_DAEMON\fR.
|
|
.SH "SETUP"
|
|
.SS "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.
|
|
.PP
|
|
If Tvheadend is started without the '-f' argument it will not daemonize
|
|
nor change its primary userid/groupid. Rather it will run with the permissions
|
|
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.
|
|
.SS "Configuration"
|
|
All configuration in Tvheadend is maintained via its embedded web server running on port 9981. Just point your browser to:
|
|
.PP
|
|
.nf
|
|
http://hostname:9981/
|
|
.fi
|
|
.PP
|
|
By default \fIeveryone (also from remote hosts)\fR is allowed \fIfull\fR
|
|
access to \fIall\fR 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.
|
|
.SS "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 created and Tvheadend
|
|
should be launched with the '-u' argument. Also notice that XMLTV will read
|
|
store cache and configuration from the user home directory.
|
|
.PP
|
|
If daemonizing, tvheadend will writes it pid in /var/run/tvheadend.pid
|
|
.SH "AUTHOR"
|
|
.B Tvheadend
|
|
and this man page is maintained by Andreas Oeman
|
|
.PP
|
|
(andreas a tvheadend d org)
|
|
.PP
|
|
You may also visit #hts at irc.freenode.net
|
|
.SH "SEE ALSO"
|
|
.BR https://tvheadend.org
|