dtas.git  about / heads / tags
duct tape audio suite for *nix
blob 41d039e36c5f42898b6cdd6083e5a17ee357feb9 2367 bytes (raw)
$ git show tfx-pu:Documentation/dtas-tl.txt	# shows this blob on the CLI

 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
77
78
79
 
% dtas-tl(1) dtas user manual

# NAME

dtas-tl - tracklist manipulation for dtas-player (development)

# SYNOPSYS

dtas-tl [COMMANDS]

# DESCRIPTION

dtas-tl provides utility functions for manipulating the tracklist of the
dtas-player (not the queue, the tracklist is separate from the queue).
It is mainly intended as a development tool and will likely go away in
the future or have its functionality merged into another tool (or MPRIS
client).

# COMMANDS

* addhead - add multiple tracks to the beginning of the tracklist
* addtail - add multiple tracks to the end of the tracklist
* current - display the current track, "NONE" if not playing
* current-id - display the TRACKID of the current track
  "NONE" if not playing
* cat - display a newline-delimited list of TRACK_ID=PATH output
  Note: this is shell-escaped, multibyte characters may not show up properly.
* clear - remove all tracks from the tracklist
* goto TRACKID [POS] - play TRACKID immediately, optionally seek to POS
TRACKID may be looked up via cat, and POS should be a timestamp in
HH:MM:SS.FRAC format.
* reto REGEXP [POS] - play first track with path matching REGEXP immediately,
optionally seek to POS.  POS should be a timestamp in HH:MM:SS.FRAC format.
* next - play the next track in the tracklist
* prev - play the previous track in the tracklist
* repeat 1 - repeat the current track
* repeat false - disable repeat
* repeat true - enable repeat of the whole tracklist

See dtas-player_protocol(7) for a detailed description of the protocol.

# EXAMPLES

display the current tracklist

        $ dtas-tl cat

to add an an entire directory of FLAC files

        $ dtas-tl addtail /path/to/directory/*.flac

to skip forward in the tracklist

        $ dtas-tl next

to skip backwards in the tracklist

        $ dtas-tl prev

# 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-2015 all contributors <dtas-all@nongnu.org>.\
License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>

# SEE ALSO

dtas-player(1), dtas-player_protocol(7), dtas-ctl(1)

git clone git://80x24.org/dtas.git
git clone https://80x24.org/dtas.git