1jack-dssi-host(1) General Commands Manual jack-dssi-host(1)
2
6 jack-dssi-host - a simple JACK host for DSSI plugins
7
9 jack-dssi-host [-v] [-a] [-n] [-p <projdir>] [-c <cname>] [-<i>] <lib‐
10 name>[:<label>] [...]
11
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
32 -v Verbose mode.
33 -a Disable automatic connection of outputs to JACK physical out‐
35 puts.
36 -n Disable automatic starting of plugin user interfaces (UIs).
38 -p <projdir>
40 The project directory to pass to both plugin and UI.
41 -c <cname>
43 The client name to use for ALSA and JACK.
44 -<i> Number of instances of the following plugin to run (max 16
46 total, default 1).
47 <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 <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 [...] Optionally more instance counts, plugins and labels.
59
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
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
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 September 18th, 2010 jack-dssi-host(1)