Actually implement auto-connection, and document it.

2019-02-16 18:45:51 +00:00
parent 4f39e0d830
commit 97370d8bce
2 changed files with 43 additions and 9 deletions
@@ -108,8 +108,14 @@ pa =
 // Parameters for the "jack" JACK Audio Connection Kit backend.
 jack =
 {
-//	client_name = "shairport-sync"; //Set this to the name of the client that should appear in "Connections" when Shairport Sync is active.
-//	autoconnect_pattern = ""; //Set this to a pattern that describes the ports you would like to connect to automatically when we start up, like "system:playback_?"
+//	client_name = "shairport-sync"; // Set this to the name of the client that should appear in "Connections" when Shairport Sync is active.
+//	autoconnect_pattern = ""; // Set this to a POSIX regular expression pattern that describes the ports you would like to connect to
+//                                   automatically. Examples:
+//                                   "system:playback_[12]"
+//                                   "some_app_[0-9]*:in-[LR]"
+//                                   "jack_mixer:in_2[78]"
+//                                   Beware: if you make a syntax error, libjack might crash. In that case, fix it and start over.
+//                                   For a good overview, look here: https://www.ibm.com/support/knowledgecenter/SS8NLW_11.0.1/com.ibm.swg.im.infosphere.dataexpl.engine.doc/c_posix-regex-examples.html
 };

 // Parameters for the "pipe" audio back end, a back end that directs raw CD-style audio output to a pipe. No interpolation is done.