silverjuke - Play and organize your music
silverjuke [options] [FILES]
This manual page documents briefly the silverjuke command.
It can be used to play and organize your music collection.
This program follows the usual GNU command line syntax, with long
options starting with two dashes ('-'). silverjuke supports
the following options:
- --ini=FILE
- set the configuration file to use to FILE
- --jukebox=FILE
- set the jukebox file to use to FILE
- --temp=DIRECTORY
- set the temporary directory to use to DIRECTORY
- --play
- start playing the current file
- --pause
- pause the playback
- --toggle
- toggle play/pause
- --prev
- play previous file in list
- --next
- play next file in list
- --kiosk
- start Silverjuke in kiosk mode
- --minimize
- start Silverjuke minimized
- --open FILES
- open the given FILES, --open may be omitted
- --enqueue FILES
- enqueue the given FILES
- --help
- Show all available commands
- --addcredit=NUM
- Adds the number of credits (tracks that may be enqueued) to the credit
system. This option only works if the option "Credits may be added by
external programs" is enabled in the kiosk mode settings.
- --setcredit=NUM
- Sets the number of credits. This option only works if the option
"Credits may be added by external programs" is enabled in the
kiosk mode settings.
- --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 "Power off" button, as in this
case the operating system may not give us the time we need to unload all
modules completely.
- --instance=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.
If you want to use different music libraries for each
instance, you have to use the --jukebox=FILE option as described
above.
- --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.
- --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).
Moreover, if you add the "clipmouse" 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.
- --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.
- --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.
- --volup
- increase the main volume
- --voldown
- decrease the main volume
- --togglevis
- toggle the selected visualizations on and off
- --execute=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.
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.
You can set the "db", "temp",
"kiosk" and "minimize" options also manually to the
current configuration file (ini file) in the section "main".
Most commands are also available through TCP/IP communication.
Björn Petersen <r10s@b44t.com>