about summary refs log tree commit homepage
path: root/Documentation/dtas-player.txt
diff options
authorEric Wong <normalperson@yhbt.net>2013-09-01 00:45:24 +0000
committerEric Wong <normalperson@yhbt.net>2013-09-01 00:45:24 +0000
commita83190e38721efdfce937965e49e572224317642 (patch)
tree32944587833695bfdb54b65b16c5bbf20a7461f9 /Documentation/dtas-player.txt
parent51180db62b4c91e2f55ee5d553a210e8effbb17f (diff)
Move all sink examples to the dtas-player_sink_examples manpage.
Remove redundant troubleshooting.txt, that now resides in
Diffstat (limited to 'Documentation/dtas-player.txt')
1 files changed, 15 insertions, 14 deletions
diff --git a/Documentation/dtas-player.txt b/Documentation/dtas-player.txt
index 0ec52c3..303bc90 100644
--- a/Documentation/dtas-player.txt
+++ b/Documentation/dtas-player.txt
@@ -53,10 +53,13 @@ created and playing the audio.
+## Audio playback does not start
 The most common problem with dtas-player is the play(1) command
-(distributed with SoX) not using the correct audio device.  Ensuring the
-play(1) command works with dtas-player is important.  See the play(1)
-documentation for details.
+(distributed with SoX) not using the correct audio device/driver.
+Ensuring the play(1) command works with dtas-player is important.
+Consult SoX documentation and mailing lists for getting play(1) to work,
 Once you find the correct AUDIODEV/AUDIODRIVER environment variables,
 you may set them via dtas-ctl(1):
@@ -65,20 +68,18 @@ To play audio on my favorite USB DAC directly to ALSA, I use:
     $ dtas-ctl sink ed default env.AUDIODEV=hw:DAC env.AUDIODRIVER=alsa
-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).
+## Seeking/playing audio from large video containers (e.g. VOB) fails
-    $ dtas-ctl sink ed dumper command='sox $SOXFMT - /tmp/dump.sox'
+This is a problem with large VOBs.  We recommend breaking up the
+VOB into smaller files or using avconv(1) or ffmpeg(1) to extract
+the desired audio stream.
-Non-"default" sinks are not active by default, but may be made active.
+      avconv -analyzeduration 2G -probesize 2G \
+        -i input.vob -vn -sn -c:a copy -map 0:$STREAM_NR output.ext
-    $ dtas-ctl sink ed dumper active=true
-Changing it again to "active=false" will deactivate the sink.
+See dtas_player-sink_examples(7) for more sink examples.
@@ -112,4 +113,4 @@ License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>
 dtas-player_protocol(7), dtas-ctl(1), dtas-enq(1), dtas-sourceedit(1),
-dtas-sinkedit(1), sox(1), play(1), screen(1), tmux(1)
+dtas-sinkedit(1), sox(1), play(1), avconv(1), ffmpeg(1), screen(1), tmux(1)