mirror of
https://github.com/Syncplay/syncplay
synced 2024-12-13 10:25:23 +00:00
5b93aeb20e
The current documentation specifies directories, likely as a result of the original design before use of a database, but the arguments expect files. This simply clarifies the documentation to match the code itself.
108 lines
3.0 KiB
Groff
108 lines
3.0 KiB
Groff
.\" Hey, EMACS: -*- nroff -*-
|
|
.\" (C) Copyright 2021 Bruno Kleinert <fuddl@debian.org>,
|
|
.\"
|
|
.\" First parameter, NAME, should be all caps
|
|
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
|
.\" other parameters are allowed: see man(7), man(1)
|
|
.TH "Syncplay Server" 1 "February 7 2021"
|
|
.\" Please adjust this date whenever revising the manpage.
|
|
.\"
|
|
.\" Some roff macros, for reference:
|
|
.\" .nh disable hyphenation
|
|
.\" .hy enable hyphenation
|
|
.\" .ad l left justify
|
|
.\" .ad b justify to both left and right margins
|
|
.\" .nf disable filling
|
|
.\" .fi enable filling
|
|
.\" .br insert line break
|
|
.\" .sp <n> insert n+1 empty lines
|
|
.\" for manpage-specific macros, see man(7)
|
|
.SH NAME
|
|
syncplay-server \- server to host syncplay rooms
|
|
.SH SYNOPSIS
|
|
.B syncplay-server
|
|
.RI [ options ]
|
|
.RI [ file ]
|
|
.RI [ playeroptions ]
|
|
.SH DESCRIPTION
|
|
This manual page documents briefly the
|
|
.B syncplay-server
|
|
command.
|
|
.PP
|
|
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
|
|
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
|
|
.\" respectively.
|
|
\fBsyncplay-server\fP is a program that syncplay clients connect to and hosts
|
|
rooms.
|
|
|
|
To host rooms for viewers via internet, make sure the server can be accessed
|
|
from the internet, i.e., its listening port is not blocked by a NAT or a
|
|
firewall.
|
|
|
|
.SH OPTIONS
|
|
|
|
This program follows the usual GNU command line syntax, with long
|
|
options starting with two dashes (`-').
|
|
A summary of options is included below.
|
|
|
|
.TP
|
|
.B \-h, \-\-help
|
|
Show summary of options.
|
|
|
|
.TP
|
|
.B \-\-port [port]
|
|
TCP port to listen for connections.
|
|
|
|
.TP
|
|
.B \-\-password [password]
|
|
Server password.
|
|
|
|
.TP
|
|
.B \-\-isolate\-rooms
|
|
Whether rooms should be isolated.
|
|
|
|
.TP
|
|
.B \-\-disable\-ready
|
|
Disable readiness feature.
|
|
|
|
.TP
|
|
.B \-\-disable\-chat
|
|
Disable the chat function.
|
|
|
|
.TP
|
|
.B \-\-salt [salt]
|
|
Random string used to generate managed room passwords.
|
|
|
|
.TP
|
|
.B \-\-motd\-file [file]
|
|
Path to a file from which motd (Message Of The Day) will be read.
|
|
|
|
.TP
|
|
.B \-\-rooms\-db-file [file]
|
|
Enables room persistence. Path is to where a database file should be loaded/create where room data will be written to and read from. This will enable rooms to persist without watchers and through restarts. Will not work if using \fB\-\-isolate\-rooms\fP.
|
|
|
|
.TP
|
|
.B \-\-permanent\-rooms-file [file]
|
|
Specifies a list of rooms that will still be listed even if their playlist is empty. Path is to where a text file with one room per line. This will require persistent rooms to be enabled.
|
|
|
|
|
|
.TP
|
|
.B \-\-max\-chat\-message\-length [maxChatMessageLength]
|
|
Maximum number of characters in one chat message (default is 150).
|
|
|
|
.TP
|
|
.B \-\-max\-username\-length [maxUsernameLength]
|
|
Maximum number of characters in a username (default is 150).
|
|
|
|
.TP
|
|
.B \-\-stats\-db\-file [file]
|
|
Enable server statistics using the SQLite database file.
|
|
|
|
.TP
|
|
.B \-\-tls [path]
|
|
Enable TLS connections using the certificate files in path.
|
|
|
|
.SH SEE ALSO
|
|
.BR syncplay (1).
|
|
|