(no commit message)
[wiki.git] / doc / using-sipbmp3.mdwn
index 6e7d8dd2388664f52dd82a2843dc06929d3aa36a..9055521bc81080aceb49870c95faae872bfbb0c6 100644 (file)
@@ -8,6 +8,16 @@ If you are running [Debathena](http://debathena.mit.edu) but do not want to use
     `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 />