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.txt | 29 +++++++++++++++-------------- 1 file changed, 15 insertions(+), 14 deletions(-) (limited to 'Documentation/dtas-player.txt') 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. # TROUBLESHOOTING +## 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, +first. 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 -# ADVANCED EXAMPLES - -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 +# ADVANCED EXAMPLES -Changing it again to "active=false" will deactivate the sink. +See dtas_player-sink_examples(7) for more sink examples. # ENVIRONMENT @@ -112,4 +113,4 @@ License: GPLv3 or later # SEE ALSO 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) -- cgit v1.2.3-24-ge0c7