.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "SILVERJUKE" 1 "2016-02-09" "16.2"
.SH NAME
silverjuke \- Play and organize your music
.SH SYNOPSIS
.sp
\fBsilverjuke\fP [\fIoptions\fP] [\fIFILES\fP]
.SH DESCRIPTION
.sp
This manual page documents briefly the \fBsilverjuke\fP command.
It can be used to play and organize your music collection.
.SH OPTIONS
.sp
This program follows the usual GNU command line syntax, with long options
starting with two dashes (\(aq\fB\-\fP\(aq). \fBsilverjuke\fP supports the following options:
.INDENT 0.0
.TP
.BI \-\-ini\fB= FILE
set the configuration file to use to FILE
.TP
.BI \-\-jukebox\fB= FILE
set the jukebox file to use to FILE
.TP
.BI \-\-temp\fB= DIRECTORY
set the temporary directory to use to DIRECTORY
.TP
.B  \-\-play
start playing the current file
.TP
.B  \-\-pause
pause the playback
.TP
.B  \-\-toggle
toggle play/pause
.TP
.B  \-\-prev
play previous file in list
.TP
.B  \-\-next
play next file in list
.TP
.B  \-\-kiosk
start Silverjuke in kiosk mode
.TP
.B  \-\-minimize
start Silverjuke minimized
.TP
.BI \-\-open \ FILES
open the given FILES, \-\-open may be omitted
.TP
.BI \-\-enqueue \ FILES
enqueue the given FILES
.TP
.B  \-\-help
Show all available commands
.TP
.BI \-\-addcredit\fB= NUM
Adds the number of credits (tracks that may be enqueued) to the credit system.
This option only works if the option \(dqCredits may be added by external
programs\(dq is enabled in the kiosk mode settings.
.TP
.BI \-\-setcredit\fB= NUM
Sets the number of credits.  This option only works if the option \(dqCredits may
be added by external programs\(dq is enabled in the kiosk mode settings.
.TP
.B  \-\-skiperrors
With this option you can avoid showing errors about an erroneous termination
on the last Silverjuke run. This is especially useful when turning off
Silverjuke using the \(dqPower off\(dq button, as in this case the operating system
may not give us the time we need to unload all modules completely.
.TP
.BI \-\-instance\fB= INI\-FILE
If you give a different INI\-file to each instance, you can use multiple
instances of Silverjuke with this option. All settings for each instance are
stored in the INI\-file, so the instances are completely independent; however,
make sure, there are no conflicts regarding the used hardware.
You can give the INI\-files as complete paths; if the files do not exist, they
are created as needed.
.sp
If you want to use different music libraries for each instance, you have to
use the \-\-jukebox=FILE option as described above.
.TP
.B  \-\-update
This will automatically update the index as if you hit F5 just after starting
Silverjuke. If you use this option in combination with \-\-kiosk and the kiosk
mode is running with limited functionality, the update process cannot be
aborted.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-kioskrect=DISPLAY|X,Y,W,H[,clipmouse]
With this option you can force the Silverjuke window to the given rectangle
when using the kiosk mode. This is useful if you want to show sth. beside the
Silverjuke window (by default, the whole screen is used).
.sp
Moreover, if you add the \(dqclipmouse\(dq modifier, the mouse cannot be moved
outside the given rectangle. Instead of X,Y,W,H you can also give a simple
DISPLAY number, the first display has the number 1.
.TP
.B \-\-visrect=DISPLAY|X,Y,W,H
Assign a static portion of the screen to the visualization. Instead of X,Y,W,H
you can also give a simple DISPLAY number, the first display has the number 1.
.TP
.B \-\-blackrect=DISPLAY|X,Y,W,H[;DISPLAY|X,Y,W,H;...]
Areas to cover by black rectangles. Instead of X,Y,W,H you can also give a
simple DISPLAY number, the first display has the number 1.
.UNINDENT
.INDENT 0.0
.TP
.B  \-\-volup
increase the main volume
.TP
.B  \-\-voldown
decrease the main volume
.TP
.B  \-\-togglevis
toggle the selected visualizations on and off
.TP
.BI \-\-execute\fB= SCRIPT_OR_FILE
Execute the given script snippet or file. With this command line option you
are able to execute any little script by the command line. For scripting
details, please refer to the Silverjuke SDK. Instead of using the command line
for this purpose, you can also use DDE, which, however, is a little bit more tricky.
.UNINDENT
.sp
Although there is always only one instance of Silverjuke running, you may call
Silverjuke with these commands which will then be forwarded to the running
instance if possible.
.sp
You can set the \(dqdb\(dq, \(dqtemp\(dq, \(dqkiosk\(dq and \(dqminimize\(dq options also manually to
the current configuration file (ini file) in the section \(dqmain\(dq.
.sp
Most commands are also available through TCP/IP communication.
.SH AUTHOR
.sp
Björn Petersen <\fI\%r10s@b44t.com\fP>
.\" Generated by docutils manpage writer.
.