X-Git-Url: https://sipb.mit.edu/gitweb.cgi/wiki.git/blobdiff_plain/5d8cd7b7566ba7f407cd458dfec827d0ec0e61e2..04ffeb2bb0b6b6bf48060f2f20c508d2b01aa16f:/doc/using-sipbmp3.mdwn

diff --git a/doc/using-sipbmp3.mdwn b/doc/using-sipbmp3.mdwn
index 32486f2..1ad79fa 100644
--- a/doc/using-sipbmp3.mdwn
+++ b/doc/using-sipbmp3.mdwn
@@ -1,7 +1,79 @@
-[Gutenbach](http://gutenbach.mit.edu/) is the software that powers sipbmp3, the system for playing music in the SIPB office. Installing it and configuring it is simple: 
+[Gutenbach](http://gutenbach.mit.edu/) is the software that powers sipbmp3, the system for playing music in the SIPB office. You can use any of the following methods to print music to play on sipbmp3.
 
-1. Download the latest version; if you're on a Debathena machine, you can run `add gutenbach` and be done (you might want to add this line to your `~/.bashrc` or `~/.profile` so you don't have to do it each time. If not, then either `git clone git://github.com/jhamrick/gutenbach.git` into a suitable directory or pick the latest download from [the downloads page](http://github.com/jhamrick/gutenbach/downloads). Then `sudo make install` in the gutenbach/ directory to install the scripts into your `/usr/local/bin` directory.
-2. `gutenbach-client-config -a sipbmp3 -h zsr.mit.edu` to tell gutenbach about the sipbmp3 queue on the machine zsr.mit.edu
-3. `gutenbach-client-config -s sipbmp3` to set sipbmp3 as the default queue.
+***
 
-That's it! You can use `gbr file.mp3` to queue a file, `gbr dir/*` to queue all the files in a directory; `gbq` to list all the files in the queue, and `gbrm [all|current|last|ID]` to remove all songs/the current song/the very last song/the song with the given ID.
+If you are running [Debathena](https://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#`<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 />
+    `CUPS_SERVER=zsr.mit.edu lp -d sipbmp3 song.mp3`
+
+***
+You can configure Gutenbach to add the queue for sipbmp3 if you are running Debathena with<br />
+    `add gutenbach`<br />
+    `gutenbach-client-config -a sipbmp3 -h zsr.mit.edu`
+
+You can set the sipbmp3 queue as your default queue with<br />
+    `gutenbach-client-config -s sipbmp3`
+
+You can play music with gutenbach with<br />
+    `gbr -q sipbmp3 song.mp3`
+
+If sipbmp3 is your default gutenbach queue, you can play music with
+gutenbach with<br />
+    `gbr song.mp3`<br />
+Similarly, you will not need to type -q sipbmp3 to do any of the
+following actions with gutenbach if you set sipbmp3 as your default
+queue.
+
+You can list what music is currently queued to sipbmp3 with<br />
+    `gbq -q sipbmp3`
+
+You can remove a song from the queue with<br />
+    `gbrm -q sipbmp3 ID`<br />
+    `gbrm -q sipbmp3 all`<br />
+    `gbrm -q sipbmp3 current`<br />
+    `gbrm -q sipbmp3 last`<br />
+which removes by job ID (found with `gbq`), all songs, current songs, or
+the last song, respectively.
+
+You can also install gutenbach by adding the PPA from https://launchpad.net/~gutenbach/+archive/gutenbach, then installing `gutenbach-client-config`.
+
+***
+
+You can change the volume on sipbmp3 with `remctl`.
+
+Get the current value of the volume with<br />
+    `remctl zsr v get`<br />
+The volume ranges from 0 to 31. It should usually stay around 15.
+
+Set the volume with<br />
+    `remctl zsr v set #`<br />
+where `#` is the volume you would like to set.
+
+Increase the volume with<br />
+    `remctl zsr v up`<br />
+
+Decrease the volume with<br />
+    `remctl zsr v down`
+
+You can mute sipbmp3 with<br />
+    `remctl zsr v mute`
+
+Apparently at some point in time the following did something<br />
+    `remctl zsr mplayer pause`