source: README @ eafb5c5

Last change on this file since eafb5c5 was 22be2fa, checked in by Jessica B. Hamrick <jhamrick@…>, 14 years ago

Remove TODO items, replacing them with a link to the Trac instance

  • Property mode set to 100644
File size: 2.4 KB
1So, you want to develop gutenbach, eh?  Good!
3Gutenbach is a distributed music player built on top of CUPs.  It
4essentially enables anybody with access to it to play music from their
5own computer -- all they have to do is "print" to the Gutenbach
6instance as they would any other document!
8The current Gutenbach features are:
9    - the Gutenbach server (packaged as gutenbach-server)
10    - a terminal queue display (packaged as gutenbach-queue)
11    - remctl bindings (packaged as gutenbach-remctl)
12    - client-side scripts to print to, list, and delete from
13      queues (packaged as gutenbach-client)
14    - a Rhythmbox plugin
15    - iTunes plugins
16    - a webapp interface
18All of these are located on GitHub:
21In terms of how the repository is structured: after discussing the
22possibility of supporting multiple systems, we decided it would be
23best to merge everything platform unspecific into the master branch,
24and then keep separate branches for each other system; e.g. at the
25moment we have the debian branch, which should be the same as the
26master branch except that it also contains a debian/ directory.  Now,
27this means that you should never edit platform-unspecific files in the
28debian directory; they should *always* be edited from the master
29branch.  The debian branch should never be merged into the master
30branch; merging should *always* happen the other way around.
32See README.old for how Gutenbach /used/ to be installed.  This can
33sometimes offer insight into how to fix things that are broken.
35Questions or comments should be directed at gutenbach AT mit DOT edu.
39- If you keep getting zephyrs with the following errors:
41      Playback completed with the following errors:
42      bt_audio_service_open: connect() failed: Connection refused (111)
43      bt_audio_service_open: connect() failed: Connection refused (111)
44      bt_audio_service_open: connect() failed: Connection refused (111)
46  This is because you have alsa configured for bluetooth, but
47  bluetooth is not enabled.  You should either enable bluetooth, or
48  uninstall the bluez-alsa package.
50- The commands to print and remove jobs should be used via the scripts
51  in gutenbach-client package.  However, if you insist on using them,
52  the correct syntax is:
54      CUPS_SERVER=servername lp -dqueuename foo.mp3
55      CUPS_SERVER=servername cancel [ID|-a] queuename
59Please file bug reports in our Trac instance, located at
Note: See TracBrowser for help on using the repository browser.