I don't think floating navboxes help anybody

[wiki.git] / doc / using-sipbmp3.mdwn

diff --git a/doc/using-sipbmp3.mdwn b/doc/using-sipbmp3.mdwn
index eb98255b3f3e2569afaa938d0fb249839b32bfc8..9055521bc81080aceb49870c95faae872bfbb0c6 100644 (file)
--- a/doc/using-sipbmp3.mdwn
+++ b/doc/using-sipbmp3.mdwn
@@ -5,9 +5,19 @@
 If you are running [Debathena](http://debathena.mit.edu) but do not want to use Gutenbach, you can use sipbmp3 like a "normal Debathena printer":<br />
     `lpr -Psipbmp3 song.mp3`<br />
     `lpq -Psipbmp3`<br />
-    `lprm -Psipbmp3 job#`
+    `lprm -Psipbmp3 job#`<br />
 If you do not specify a job number, then the first song will be removed.
 
+You can specify start and stop times with options:<br />
+    `lpr -Psipbmp3 song.mp3 -o start=10 -o stop=123`
+
+The numbers are in seconds, but you can also use syntax like `4m33s` or `4:33`. Instead of specifying a music file, you can alternatively print a YouTube URL from the standard input; there, you can also append flags like `start=10 stop=123` to the line, so for example you can print the line<br />
+`https://www.youtube.com/watch?v=a3ww0gwEszo start=10 stop=123`<br />
+Finally, you can use various synonyms for "start" or "stop", such as "begin" and "end", because the author keeps on accidentally typing the latter.
+
+*Experimental feature*: if you add `playlist` to the end of a YouTube playlist URL, sipbmp3 will attempt to queue up all the videos in the playlist. You can also add things like `start=1 stop=3`, this time to limit to a range of videos in the playlist. This is a ridiculous tower of hacks; don't look at the code.<br />
+    `https://www.youtube.com/watch?v=A2VpR8HahKc&list=PLSdoVPM5WnndSQEXRz704yQkKwx76GvPV playlist`
+
 ***
 
 If you are not running Debathena, you can use the following command to print music to sipbmp3<br />