about summary refs log tree commit homepage
path: root/Documentation
diff options
authorEric Wong <normalperson@yhbt.net>2013-08-27 20:22:41 +0000
committerEric Wong <normalperson@yhbt.net>2013-08-27 20:22:41 +0000
commit4679d5f1012c4e0de28fee9fff0f3edddf1bc74f (patch)
tree4f58d7e3d2cd2cd18ea3d981e6d43639d2ed967a /Documentation
parent3f8e20d745a8163bd9b199e0047bf98a952ed092 (diff)
This adds examples for using ssh(1) with play(1)
Diffstat (limited to 'Documentation')
1 files changed, 26 insertions, 0 deletions
diff --git a/Documentation/dtas-player_sink_examples.txt b/Documentation/dtas-player_sink_examples.txt
index 30f6846..eb3e1e1 100644
--- a/Documentation/dtas-player_sink_examples.txt
+++ b/Documentation/dtas-player_sink_examples.txt
@@ -11,6 +11,7 @@ dtas-sinkedit SINKNAME
+To use oggfwd(1) and Icecast, the following sink works.
 Warning: the following example will likely expose your Icecast source
 password to any local users on the system.
@@ -18,3 +19,28 @@ password to any local users on the system.
     name: oggfwd
     command: sox $SOXFMT - -t ogg - | oggfwd $HOST $PORT $PASS /dtas.ogg
+Alternatively, if you have play(1) installed on any remote host and
+a slow connection using Ogg-Vorbis:
+    # Long lines in YAML can be broken up and the subsequent lines
+    # indented with by spaces
+    ---
+    name: ssh-remote
+    command: sox $SOXFMT - -t ogg - |
+      ssh $HOST env AUDIODEV=... play -q -t ogg -
+    # Note the use of env(1), as the "env" parameter for the sink may not be
+    # passed via ssh to the remote $HOST depending on the ssh_config(5)
+    # configuration.
+If you have a fast connection, there is no need to encode using
+Ogg-Vorbis.  Alternatively, you may also use "flac" instead of "ogg" in
+the above Ogg-Vorbis example.
+    ---
+    name: ssh-remote
+    command: ssh $HOST env AUDIODEV=... play -q $SOXFMT -
+sox(1), play(1), oggfwd(1), ssh(1), ssh_config(5), env(1)