tpying si ardh
[wiki.git] / doc / using-sipbmp3.mdwn
index 32486f286a5675bb7da19d1b0a2685df822c9be3..6e7d8dd2388664f52dd82a2843dc06929d3aa36a 100644 (file)
@@ -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":<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.
+
+***
+
+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`