Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
jack-dssi-host(1)	    General Commands Manual	     jack-dssi-host(1)

NAME
       jack-dssi-host -	a simple JACK host for DSSI plugins

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

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

OPTIONS
       -v     Verbose mode.

       -a     Disable automatic	connection of outputs to  JACK	physical  out-
	      puts.

       -n     Disable automatic	starting of plugin user	interfaces (UIs).

       -p <projdir>
	      The project directory to pass to both plugin and UI.

       -c <cname>
	      The client name to use for ALSA and JACK.

       -<i>   Number  of  instances of the following plugin to run (max	16 to-
	      tal, default 1).

       <libname>
	      Name of the DSSI plugin shared library (.so) to load.  This  may
	      be  an  absolute	path to	the library file, or just the filename
	      itself, in which case the	DSSI search path is searched (see  EN-
	      VIRONMENT	below).

       <label>
	      the  label  of  the plugin to load from the library.  If this is
	      omitted, the first plugin	in the library is used.

       [...]  Optionally more instance counts, plugins and labels.

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

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

AUTHOR
       This  manual  page  was originally created by Mark Hymers from the help
       text of the application,	for the	Debian project (but may	be freely used
       by others).

			     September 18th, 2010	     jack-dssi-host(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=jack-dssi-host&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help