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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
% 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
* edit - spawn an editor to allow editing the tracklist as a text file
See EDITING for more information.
* 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
# EDITING
It is possible to edit the player tracklist from your favorite text
editor. Existing lines denoting tracks may be rearranged, deleted,
copied or entirely new lines with path names (without a trailing "
=TRACK_ID") may be added.
Changes to the tracklist are sent to the player when the user exits the
editor. This functionality only works when there is one user editing
the tracklist at a time, and when no files in the tracklist contain rare
newline characters.
# ENVIRONMENT
VISUAL / EDITOR - your favorite *nix text editor, defaults to 'vi' if unset.
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: GPL-3.0+ <http://www.gnu.org/licenses/gpl-3.0.txt>
# SEE ALSO
dtas-player(1), dtas-player_protocol(7), dtas-ctl(1)
|