From 93f9583bb32dda6f6c003ef0487053974f167b27 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Mon, 14 Dec 2015 02:15:28 +0000 Subject: dtas-tl: learn an "edit" sub command This should allow convenient rearranging and deleting of tracks from the tracklist from your favorite $EDITOR. --- Documentation/dtas-tl.txt | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) (limited to 'Documentation') 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 -- cgit v1.2.3-24-ge0c7