Convert most http: links to https:
[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](https://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 You can specify start and stop times with options:<br />
12     `lpr -Psipbmp3 song.mp3 -o start=10 -o stop=123`
13
14 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 />
15 `https://www.youtube.com/watch?v=a3ww0gwEszo start=10 stop=123`<br />
16 Finally, you can use various synonyms for "start" or "stop", such as "begin" and "end", because the author keeps on accidentally typing the latter.
17
18 *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 />
19     `https://www.youtube.com/watch?v=A2VpR8HahKc&list=PLSdoVPM5WnndSQEXRz704yQkKwx76GvPV playlist`
20
21 ***
22
23 If you are not running Debathena, you can use the following command to print music to sipbmp3<br />
24     `CUPS_SERVER=zsr.mit.edu lp -d sipbmp3 song.mp3`
25
26 ***
27 You can configure Gutenbach to add the queue for sipbmp3 if you are running Debathena with<br />
28     `add gutenbach`<br />
29     `gutenbach-client-config -a sipbmp3 -h zsr.mit.edu`
30
31 You can set the sipbmp3 queue as your default queue with<br />
32     `gutenbach-client-config -s sipbmp3`
33
34 You can play music with gutenbach with<br />
35     `gbr -q sipbmp3 song.mp3`
36
37 If sipbmp3 is your default gutenbach queue, you can play music with
38 gutenbach with<br />
39     `gbr song.mp3`<br />
40 Similarly, you will not need to type -q sipbmp3 to do any of the
41 following actions with gutenbach if you set sipbmp3 as your default
42 queue.
43
44 You can list what music is currently queued to sipbmp3 with<br />
45     `gbq -q sipbmp3`
46
47 You can remove a song from the queue with<br />
48     `gbrm -q sipbmp3 ID`<br />
49     `gbrm -q sipbmp3 all`<br />
50     `gbrm -q sipbmp3 current`<br />
51     `gbrm -q sipbmp3 last`<br />
52 which removes by job ID (found with `gbq`), all songs, current songs, or
53 the last song, respectively.
54
55 You can also install gutenbach by adding the PPA from https://launchpad.net/~gutenbach/+archive/gutenbach, then installing `gutenbach-client-config`.
56
57 ***
58
59 You can change the volume on sipbmp3 with `remctl`.
60
61 Get the current value of the volume with<br />
62     `remctl zsr v get`<br />
63 The volume ranges from 0 to 31. It should usually stay around 15.
64
65 Set the volume with<br />
66     `remctl zsr v set #`<br />
67 where `#` is the volume you would like to set.
68
69 Increase the volume with<br />
70     `remctl zsr v up`<br />
71
72 Decrease the volume with<br />
73     `remctl zsr v down`
74
75 You can mute sipbmp3 with<br />
76     `remctl zsr v mute`
77
78 Apparently at some point in time the following did something<br />
79     `remctl zsr mplayer pause`