NAME

       jack-plumbing - JACK Plumbing Daemon

SYNOPSIS

       jack-plumbing [options] [rule-files]

OPTIONS

       -d : Do not operate as a daemon.

       -o : Do not load ordinary rule files.

       -q : Quiet operation.

       -u : Set the time, in micro-seconds, that must elapse after a connection notification to
       indicate the end of a notification set (default=30000). This is an optimization switch.

DESCRIPTION

       jack-plumbing maintains a set of port connection rules and manages these as clients
       register ports with JACK- Port names are implicitly bounded regular expressions and
       support sub-expression patterns.

       There are four rules: connect, disconnect, also-connect and connect-exclusive.

           (connect "SuperCollider:out_(.*)" "system:playback_\1")

       This connect rule ensures that whenever scsynth(1) is running any output ports it
       registers are connected to appropriate ALSA playback ports. The connect rule only makes a
       connection if none already exist.

           (also-connect "system:playback_1" "jack-udp-[0-9]*:in_1")

       This also-connect rule ensures that when jack-udp(1) is running in send mode all signals
       that are ordinarily sent to the local audio interface will also be sent to the network
       destination. The also-connect aliasing applies to both the left and right hand side of
       connect rules.

           (connect-exclusive "SuperCollider:out_(.*)" "ardour:sc3_in_\1/in 1")

       This connect-exclusive rule ensures that if SuperCollider and an ardour(1) session with
       appropriate tracks are both running that SuperCollider gets connected to ardour and
       disconnected from everything else.

       This type of connection daemon has the following advantages over both environment
       variables and command line arguments:

       •   it does not require any client connection support or logic at all

       •   it provides a uniform user interface to all clients

       •   it has a somewhat declarative style

       This type of daemon is very lightweight and non-intrusive: it requires no arguments, it
       runs from an unprivileged thread, if the rule set is empty it is a no-op, it does not
       write any files, it does not require any modification to clients or to how clients are
       started.

       When a set of port registrations is made it checks the modification time of the rule set
       files, /etc/jack-plumbing and ~/.jack-plumbing, and any files specified by the user,
       rereads the rule set if it has been updated, then makes the JACK graph obey the rules.

       Any lines beginning with a semi-colon are ignored.

       The rule set is sorted, disconnect rules are applied first, then connect rules, then
       connect-exclusive rules.

FILES

       •   /etc/jack-plumbing

       •   ~/.jack-plumbing

AUTHOR

       Written by Rohan Drape http://slavepianos.org/rd/

SEE ALSO

       jackd(1)

AUTHOR

       Rohan Drape <rd@slavepianos.org>
           Author.

                                            05/03/2018                           JACK-PLUMBING(1)