From a83190e38721efdfce937965e49e572224317642 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Sun, 1 Sep 2013 00:45:24 +0000 Subject: doc: reorganize sections around dtas-player Move all sink examples to the dtas-player_sink_examples manpage. Remove redundant troubleshooting.txt, that now resides in dtas-player(1). --- Documentation/dtas-player_sink_examples.txt | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) (limited to 'Documentation/dtas-player_sink_examples.txt') diff --git a/Documentation/dtas-player_sink_examples.txt b/Documentation/dtas-player_sink_examples.txt index cb85aa8..0aceb89 100644 --- a/Documentation/dtas-player_sink_examples.txt +++ b/Documentation/dtas-player_sink_examples.txt @@ -11,6 +11,8 @@ dtas-sinkedit SINKNAME # EXAMPLES +## Streaming Ogg-Vorbis to Icecast + 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. @@ -20,6 +22,8 @@ password to any local users on the system. name: oggfwd command: sox $SOXFMT - -t ogg - | oggfwd $HOST $PORT $PASS /dtas.ogg +## Stream to a remote host via ssh + Alternatively, if you have play(1) installed on any remote host and a slow connection using Ogg-Vorbis: @@ -42,6 +46,21 @@ the above Ogg-Vorbis example. name: ssh-remote command: ssh $HOST env AUDIODEV=... play -q $SOXFMT - +## Dump audio to a file during playback + +To configure a dumper sink (in addition to the "default" sink). Note +the use of $SOXFMT, this will be automatically expanded to match the +internal format of the player. The internal format of the player is +described in dtas-player_protocol(7). + + $ dtas-ctl sink ed dumper command='sox $SOXFMT - /tmp/dump.sox' + +Non-"default" sinks are not active by default, but may be made active. + + $ dtas-ctl sink ed dumper active=true + +Changing it again to "active=false" will deactivate the sink. + # COPYRIGHT Copyright 2013, Eric Wong and all contributors.\ -- cgit v1.2.3-24-ge0c7