diff options
author | Eric Wong <e@80x24.org> | 2015-12-14 02:15:28 +0000 |
---|---|---|
committer | Eric Wong <e@80x24.org> | 2015-12-14 02:55:22 +0000 |
commit | 93f9583bb32dda6f6c003ef0487053974f167b27 (patch) | |
tree | ce55dd088d1266ad97a796d5f1131a13386291ae /Documentation | |
parent | d9eacbda3c5bc3b6d3a7c15f8c47a0657ef7e683 (diff) | |
download | dtas-93f9583bb32dda6f6c003ef0487053974f167b27.tar.gz |
This should allow convenient rearranging and deleting of tracks from the tracklist from your favorite $EDITOR.
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/dtas-tl.txt | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/Documentation/dtas-tl.txt b/Documentation/dtas-tl.txt index 41d039e..51c8bc1 100644 --- a/Documentation/dtas-tl.txt +++ b/Documentation/dtas-tl.txt @@ -26,6 +26,8 @@ client). * 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. @@ -57,8 +59,22 @@ 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 |