git event
[wiki.git] / doc / using-sipbmp3.mdwn
1 [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.
2
3 ***
4
5 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 />
6     `lpr -Psipbmp3 song.mp3`<br />
7     `lpq -Psipbmp3`<br />
8     `lprm -Psipbmp3 job#`<br />
9 If you do not specify a job number, then the first song will be removed.
10
11 ***
12
13 If you are not running Debathena, you can use the following command to print music to sipbmp3<br />
14     `CUPS_SERVER=zsr.mit.edu lp -d sipbmp3 song.mp3`
15
16 ***
17 You can configure Gutenbach to add the queue for sipbmp3 if you are running Debathena with<br />
18     `add gutenbach`<br />
19     `gutenbach-client-config -a sipbmp3 -h zsr.mit.edu`
20
21 You can set the sipbmp3 queue as your default queue with<br />
22     `gutenbach-client-config -s sipbmp3`
23
24 You can play music with gutenbach with<br />
25     `gbr -q sipbmp3 song.mp3`
26
27 If sipbmp3 is your default gutenbach queue, you can play music with
28 gutenbach with<br />
29     `gbr song.mp3`<br />
30 Similarly, you will not need to type -q sipbmp3 to do any of the
31 following actions with gutenbach if you set sipbmp3 as your default
32 queue.
33
34 You can list what music is currently queued to sipbmp3 with<br />
35     `gbq -q sipbmp3`
36
37 You can remove a song from the queue with<br />
38     `gbrm -q sipbmp3 ID`<br />
39     `gbrm -q sipbmp3 all`<br />
40     `gbrm -q sipbmp3 current`<br />
41     `gbrm -q sipbmp3 last`<br />
42 which removes by job ID (found with `gbq`), all songs, current songs, or
43 the last song, respectively.
44
45 You can also install gutenbach by adding the PPA from https://launchpad.net/~gutenbach/+archive/gutenbach, then installing `gutenbach-client-config`.
46
47 ***
48
49 You can change the volume on sipbmp3 with `remctl`.
50
51 Get the current value of the volume with<br />
52     `remctl zsr v get`<br />
53 The volume ranges from 0 to 31. It should usually stay around 15.
54
55 Set the volume with<br />
56     `remctl zsr v set #`<br />
57 where `#` is the volume you would like to set.
58
59 Increase the volume with<br />
60     `remctl zsr v up`<br />
61
62 Decrease the volume with<br />
63     `remctl zsr v down`
64
65 You can mute sipbmp3 with<br />
66     `remctl zsr v mute`
67
68 Apparently at some point in time the following did something<br />
69     `remctl zsr mplayer pause`