1jack-dssi-host(1)           General Commands Manual          jack-dssi-host(1)
2
3
4

NAME

6       jack-dssi-host - a simple JACK host for DSSI plugins
7

SYNOPSIS

9       jack-dssi-host  [-v] [-a] [-n] [-p <projdir>] [-c <cname>] [-<i>] <lib‐
10       name>[:<label>] [...]
11

DESCRIPTION

13       jack-dssi-host is a simple DSSI host that listens for MIDI events on an
14       ALSA  sequencer  port, delivers them to DSSI synth plugins, and outputs
15       the resulting audio via JACK.
16       jack-dssi-host can host up to 16 instances of DSSI synth plugins,  each
17       of  which is sequentially assigned a MIDI channel from 1 to 16.  Plugin
18       outputs (if `-a' is not specified) are connected  sequentially  to  the
19       available  JACK  physical output ports, wrapping back to the first JACK
20       port whenever the available ports are exhausted.   Plugin  user  inter‐
21       faces  (UIs)  are started for each instance (if '-n' is not specified.)
22       jack-dssi-host will exit when the last plugin UI has exited.
23       As a special case, if jack-dssi-host is started with a name other  than
24       `jack-dssi-host',  and if that name (plus an `.so' suffix) can be found
25       in the DSSI_PATH search path (see ENVIRONMENT below) as a valid  plugin
26       shared  library,  and  if  no further command line arguments are given,
27       then the first plugin in that library  will  be  loaded  automatically.
28       This provides a convenient way to run a plugin by simply symlinking the
29       plugin's basename to jack-dssi-host.
30

OPTIONS

32       -v     Verbose mode.
33
34       -a     Disable automatic connection of outputs to  JACK  physical  out‐
35              puts.
36
37       -n     Disable automatic starting of plugin user interfaces (UIs).
38
39       -p <projdir>
40              The project directory to pass to both plugin and UI.
41
42       -c <cname>
43              The client name to use for ALSA and JACK.
44
45       -<i>   Number  of  instances  of  the  following  plugin to run (max 16
46              total, default 1).
47
48       <libname>
49              Name of the DSSI plugin shared library (.so) to load.  This  may
50              be  an  absolute  path to the library file, or just the filename
51              itself, in which case the DSSI  search  path  is  searched  (see
52              ENVIRONMENT below).
53
54       <label>
55              the  label  of  the plugin to load from the library.  If this is
56              omitted, the first plugin in the library is used.
57
58       [...]  Optionally more instance counts, plugins and labels.
59

EXAMPLE

61       jack-dssi-host -2 lib1.so -1 lib2.so:fuzzy
62       Runs two instances of the first plugin found in  lib1.so,  assigned  to
63       MIDI  channels  1  and 2 and connected to the first available JACK out‐
64       puts, and one instance of the "fuzzy" plugin in lib2.so on MIDI channel
65       3 and connected to the next available JACK output.
66

ENVIRONMENT

68       jack-dssi-host  will search for plugin shared libraries in the directo‐
69       ries specified by the environment variable DSSI_PATH, which is a colon-
70       separated  list  of  directories.  If  DSSI_PATH  is not set, a default
71       search path of /usr/lib64/dssi,  /usr/local/lib64/dssi,  /usr/lib/dssi,
72       /usr/local/lib/dssi,  and  (assuming  the  environment variable HOME is
73       set,) $HOME/.dssi is used.
74

AUTHOR

76       This manual page was originally created by Mark Hymers  from  the  help
77       text of the application, for the Debian project (but may be freely used
78       by others).
79
80
81
82                             September 18th, 2010            jack-dssi-host(1)
Impressum