diff options
author | Eric Wong <normalperson@yhbt.net> | 2013-08-24 23:58:08 +0000 |
---|---|---|
committer | Eric Wong <normalperson@yhbt.net> | 2013-08-24 23:58:08 +0000 |
commit | 97b851b0dad8f6a3c3352bdff8f4a3aac539d354 (patch) | |
tree | 4a324e416932f51012a283cfeb4b208d2b6fd8ec /Documentation/dtas-ctl.1.txt | |
parent | 09178fca7320ed4919b7c5e845598f9ad998d6d3 (diff) | |
download | dtas-97b851b0dad8f6a3c3352bdff8f4a3aac539d354.tar.gz |
We should probably document this before we forget it.
Diffstat (limited to 'Documentation/dtas-ctl.1.txt')
-rw-r--r-- | Documentation/dtas-ctl.1.txt | 64 |
1 files changed, 64 insertions, 0 deletions
diff --git a/Documentation/dtas-ctl.1.txt b/Documentation/dtas-ctl.1.txt new file mode 100644 index 0000000..68b6c74 --- /dev/null +++ b/Documentation/dtas-ctl.1.txt @@ -0,0 +1,64 @@ +% dtas-ctl(1) dtas user manual +% + +# NAME + +dtas-ctl - low-level client for dtas-player + +# SYNOPSYS + +dtas-ctl [ARGS...] + +# DESCRIPTION + +dtas-ctl passes command-line arguments as-is to dtas-player. It is mainly +useful for simple commands such as ("current", "play_pause", "pause", "play", +"rg RGARGS", "seek HH:MM:SS", "skip"). + +See dtas-player_protocol(7) for a detailed description of the protocol. + +# EXAMPLES + +display the currently playing track + + $ dtas-ctl current + +enqueue a file for playback (dtas-enq(1) is easier to use, here) + + $ dtas-ctl enq /absolute/path/to/file + +toggle the play/pause state of the player + + $ dtas-ctl play_pause + +change the ReplayGain mode + + $ dtas-ctl rg mode=album_gain + # "track_gain", "off" may be used, too + +seek 5 seconds forward + + $ dtas-ctl seek +5 + +seek to an absolute position + + $ dtas-ctl seek 1:00 + +skip to the next track + + $ dtas-ctl skip + +To play the output of an arbitrary command (note the quotes) and usage +of $SOXFMT (see dtas-player_protocol(7)). + + $ dtas-ctl enq-cmd 'sox -n $SOXFMT - synth 3 pluck' + +# ENVIRONMENT + +DTAS_PLAYER_SOCK - the path to the dtas-player control socket. +This defaults to ~/.dtas/player.sock + +# SEE ALSO + +dtas-player(1), dtas-player_protocol(7), dtas-enq(1), dtas-sinkedit(1), +dtas-sourceedit(1) |