Contents

.TH dtas-ctl 1 "" "dtas user manual"
.SH NAME
.PP
dtas-ctl - low-level client for dtas-player
.SH SYNOPSYS
.PP
dtas-ctl [ARGS...]
.SH DESCRIPTION
.PP
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").
.PP
See dtas-player_protocol(7) for a detailed description of the protocol.
.SH EXAMPLES
.PP
display the currently playing track
.IP
.nf
\f[C]
\ \ \ \ $\ dtas-ctl\ current
\f[]
.fi
.PP
enqueue a file for playback (dtas-enq(1) is easier to use, here)
.IP
.nf
\f[C]
\ \ \ \ $\ dtas-ctl\ enq\ /absolute/path/to/file
\f[]
.fi
.PP
toggle the play/pause state of the player
.IP
.nf
\f[C]
\ \ \ \ $\ dtas-ctl\ play_pause
\f[]
.fi
.PP
change the ReplayGain mode
.IP
.nf
\f[C]
\ \ \ \ $\ dtas-ctl\ rg\ mode=album_gain
\ \ \ \ #\ "track_gain",\ "off"\ may\ be\ used,\ too
\f[]
.fi
.PP
seek 5 seconds forward
.IP
.nf
\f[C]
\ \ \ \ $\ dtas-ctl\ seek\ +5
\f[]
.fi
.PP
seek to an absolute position
.IP
.nf
\f[C]
\ \ \ \ $\ dtas-ctl\ seek\ 1:00
\f[]
.fi
.PP
skip to the next track
.IP
.nf
\f[C]
\ \ \ \ $\ dtas-ctl\ skip
\f[]
.fi
.PP
To play the output of an arbitrary command (note the quotes) and usage
of $SOXFMT (see dtas-player_protocol(7)).
.IP
.nf
\f[C]
$\ dtas-ctl\ enq-cmd\ \[aq]sox\ -n\ $SOXFMT\ -\ synth\ 3\ pluck\[aq]
\f[]
.fi
.SH ENVIRONMENT
.PP
DTAS_PLAYER_SOCK - the path to the dtas-player control socket.
This defaults to ~/.dtas/player.sock
.SH CONTACT
.PP
All feedback welcome via plain-text mail to <[e-mail]>
.PD 0
.P
.PD
Mailing list archives available at <ftp://lists.gnu.org/dtas-all/>
.PD 0
.P
.PD
No subscription is necessary to post to the mailing list.
.SH COPYRIGHT
.PP
Copyright 2013-2014, Eric Wong <[e-mail]> and all contributors.
.PD 0
.P
.PD
License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>
.SH SEE ALSO
.PP
dtas-player(1), dtas-player_protocol(7), dtas-enq(1), dtas-sinkedit(1),
dtas-sourceedit(1)

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
dtas-0.9.0	man/dtas-ctl.1
dtas-0.8.0	man/dtas-ctl.1