# Contributing Firstly, thanks for reading this. Pull requests, bug reports, feature requests, etc. are all very welcome (including ones from non-developers). For bug reports about `build_and_install.sh`, please include your `build_and_install.log`. (It should be written to the same directory as `build_and_install.sh`.) For bug reports about Background Music itself, if you feel like being really helpful, you could reproduce your bug with a debug build and include the relevant logs. But don't feel obligated to. You can build and install a debug build with `./build_and_install.sh -d`. BGMDriver and BGMXPCHelper log messages to system.log by default. You can read them in Console.app. BGMApp's logs go to stdout, except errors or warnings that should be visible to users, which go to syslog. To get BGMApp's logs either run it in Xcode or from a terminal (e.g. `$ /Applications/Background\ Music.app/Contents/MacOS/Background\ Music`). I'm working on adding logging to release builds and generally making the process easier. The code is mostly C++ and Objective-C. But don't worry if you don't know those languages--I don't either. Or Core Audio, for that matter. No dependencies so far, though you're welcome to add some. The best place to start is probably `DEVELOPING.md`, which has an overview of the project and instructions for building, debugging, etc. It's kind of long, though, and not very interesting, so you might prefer to go straight into the code. If you've got questions related to Core Audio, the [Core Audio mailing list](https://lists.apple.com/archives/coreaudio-api) is very useful. There's also the [Core Audio Overview](https://developer.apple.com/library/mac/documentation/MusicAudio/Conceptual/CoreAudioOverview/Introduction/Introduction.html) and the [Core Audio Glossary](https://developer.apple.com/library/mac/documentation/MusicAudio/Reference/CoreAudioGlossary/Glossary/core_audio_glossary.html).