X-Git-Url: https://sipb.mit.edu/gitweb.cgi/wiki.git/blobdiff_plain/5d8cd7b7566ba7f407cd458dfec827d0ec0e61e2..85e6e94391e54ef83035c2203a9334ef3d4c6570:/doc/using-sipbmp3.mdwn
diff --git a/doc/using-sipbmp3.mdwn b/doc/using-sipbmp3.mdwn
index 32486f2..6e7d8dd 100644
--- a/doc/using-sipbmp3.mdwn
+++ b/doc/using-sipbmp3.mdwn
@@ -1,7 +1,69 @@
-[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](http://debathena.mit.edu) but do not want to use Gutenbach, you can use sipbmp3 like a "normal Debathena printer":
+ `lpr -Psipbmp3 song.mp3`
+ `lpq -Psipbmp3`
+ `lprm -Psipbmp3 job#`
+If you do not specify a job number, then the first song will be removed.
+
+***
+
+If you are not running Debathena, you can use the following command to print music to sipbmp3
+ `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
+ `add gutenbach`
+ `gutenbach-client-config -a sipbmp3 -h zsr.mit.edu`
+
+You can set the sipbmp3 queue as your default queue with
+ `gutenbach-client-config -s sipbmp3`
+
+You can play music with gutenbach with
+ `gbr -q sipbmp3 song.mp3`
+
+If sipbmp3 is your default gutenbach queue, you can play music with
+gutenbach with
+ `gbr song.mp3`
+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
+ `gbq -q sipbmp3`
+
+You can remove a song from the queue with
+ `gbrm -q sipbmp3 ID`
+ `gbrm -q sipbmp3 all`
+ `gbrm -q sipbmp3 current`
+ `gbrm -q sipbmp3 last`
+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
+ `remctl zsr v get`
+The volume ranges from 0 to 31. It should usually stay around 15.
+
+Set the volume with
+ `remctl zsr v set #`
+where `#` is the volume you would like to set.
+
+Increase the volume with
+ `remctl zsr v up`
+
+Decrease the volume with
+ `remctl zsr v down`
+
+You can mute sipbmp3 with
+ `remctl zsr v mute`
+
+Apparently at some point in time the following did something
+ `remctl zsr mplayer pause`