about summary refs log tree commit homepage
path: root/Documentation/dtas-ctl.txt
blob: b2cf20b99695a1794b71504b97c9b69984ee7f0a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
% 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

# CONTACT

All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
Mailing list archives available at <http://80x24.org/dtas-all/> and
<ftp://lists.gnu.org/dtas-all/>\
No subscription is necessary to post to the mailing list.

# COPYRIGHT

Copyright 2013-2016 all contributors <dtas-all@nongnu.org>.\
License: GPL-3.0+ <http://www.gnu.org/licenses/gpl-3.0.txt>

# SEE ALSO

dtas-player(1), dtas-player_protocol(7), dtas-enq(1), dtas-sinkedit(1),
dtas-sourceedit(1)