NAME

       silverjuke - Play and organize your music

SYNOPSIS

       silverjuke [options] [FILES]

DESCRIPTION

       This  manual  page  documents  briefly  the silverjuke command.  It can be used to play and organize your
       music collection.

OPTIONS

       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.

AUTHOR

       Björn Petersen <r10s@b44t.com>