mirror of
https://github.com/kyleneideck/BackgroundMusic
synced 2025-02-26 11:57:08 +00:00
Add some related projects to README and other minor doc clean up.
In the manual uninstallation instructions, makes the command for restarting coreaudiod clearer. If the old command had to fallback to "sudo killall coreaudiod", it wasn't clear to the user that it had actually succeeded.
This commit is contained in:
parent
7f136586dc
commit
ac1df8d77c
3 changed files with 30 additions and 7 deletions
|
@ -9,7 +9,12 @@
|
|||
<sup>(Open `/Applications/Utilities/Terminal.app` and paste the following at the prompt.)</sup>
|
||||
|
||||
```shell
|
||||
sudo launchctl kill SIGTERM system/com.apple.audio.coreaudiod || sudo killall coreaudiod
|
||||
sudo launchctl kill -15 system/com.apple.audio.coreaudiod
|
||||
```
|
||||
or, if that fails
|
||||
|
||||
```shell
|
||||
sudo killall coreaudiod
|
||||
```
|
||||
- Go to the Sound section in System Preferences and change your default output device at least once. (If you only have
|
||||
one device now, either use `Audio MIDI Setup.app` to create a temporary aggregate device, restart any audio apps that
|
||||
|
|
27
README.md
27
README.md
|
@ -14,8 +14,8 @@
|
|||
- No restart required to install
|
||||
- Runs entirely in userspace
|
||||
|
||||
**Version 0.1.0**, first release. Probably very buggy. Pretty much only tested on one system (a MacBook running OS X
|
||||
10.11 using the built-in audio device).
|
||||
**Version 0.1.0**, first release. Probably very buggy. Pretty much only tested on one system. (A MacBook running OS X
|
||||
10.11 using the built-in audio device.)
|
||||
|
||||
**Requires OS X 10.10+**. Might work on 10.9, but I haven't tried it.
|
||||
|
||||
|
@ -63,8 +63,8 @@ apps playing audio.
|
|||
|
||||
### Manual Uninstall
|
||||
|
||||
Try following the instructions in `MANUAL-UNINSTALL.md` if `uninstall.sh` fails. (You might consider submitting a bug
|
||||
report, too.)
|
||||
Try following the instructions in [`MANUAL-UNINSTALL.md`](MANUAL-UNINSTALL.md) if `uninstall.sh` fails. (You might
|
||||
consider submitting a bug report, too.)
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
|
@ -90,13 +90,17 @@ change the default device and then change it back again. Failing that, you might
|
|||
- [A recent Chrome bug](https://bugs.chromium.org/p/chromium/issues/detail?id=557620) can stop Chrome from switching to
|
||||
Background Music Device after you open Background Music. Chrome's audio will still play, but Background Music won't be
|
||||
aware of it.
|
||||
- Some apps play notification sounds that are only just long enough to trigger an auto-pause. The only workaround right
|
||||
now is to increase the `kPauseDelayMSecs` constant in `BGMApp/BGMAutoPauseMusic.mm`. That will make your music overlap
|
||||
the other audio for longer, though, so you don't want to increase it too much. See
|
||||
[#5](https://github.com/kyleneideck/BackgroundMusic/issues/5) for details.
|
||||
- Plenty more. Some are in listed in TODO.md.
|
||||
|
||||
## Related projects
|
||||
|
||||
- [Core Audio User-Space Driver
|
||||
Examples](https://developer.apple.com/library/mac/samplecode/AudioDriverExamples/Introduction/Intro.html)
|
||||
The sample code from Apple that BGMDriver's based on.
|
||||
The sample code from Apple that BGMDriver is based on.
|
||||
- [Soundflower](https://github.com/mattingalls/Soundflower) - "MacOS system extension that allows applications to pass
|
||||
audio to other applications."
|
||||
- [WavTap](https://github.com/pje/WavTap) - "globally capture whatever your mac is playing—-as simply as a screenshot"
|
||||
|
@ -104,13 +108,24 @@ change the default device and then change it back again. Failing that, you might
|
|||
user/kernel audio interface. Shows how to read audio straight out of the kernel as you would on Darwin (where most the
|
||||
OSX goodness is missing)"
|
||||
- [mute.fm](http://www.mute.fm), [GitHub](https://github.com/jaredsohn/mutefm) (Windows) - Auto-pause music
|
||||
- [Sound Siphon](http://staticz.com) (non-free) - System/app audio recording, per-app volumes, system audio equaliser
|
||||
- [Jack OS X](http://www.jackosx.com) - "A Jack audio connection kit implementation for Mac OS X"
|
||||
- [PulseAudio OS X](https://github.com/zonque/PulseAudioOSX) - "PulseAudio for Mac OS X"
|
||||
- [Sound Pusher](https://github.com/q-p/SoundPusher) - "Virtual audio device, real-time encoder and SPDIF forwarder for
|
||||
Mac OS X"
|
||||
- [eqMac](http://www.bitgapp.com/eqmac/) - "System-wide Audio Equalizer for Mac OSX"
|
||||
- [Zirkonium](https://code.google.com/archive/p/zirkonium) - "An infrastructure and application for multi-channel sound
|
||||
spatialization on MacOS X."
|
||||
|
||||
### Non-free
|
||||
|
||||
- [Volume Mixer For Mac](http://www.volumemixer-app.com/) - "Application specific volume control for Mac OS Yosemite and
|
||||
El Capitan"
|
||||
- [Sound Siphon](http://staticz.com) - System/app audio recording, per-app volumes, system audio equaliser
|
||||
- [SoundBunny](https://www.prosofteng.com/soundbunny-mac-volume-control/) - "Control application volume independently."
|
||||
- [Boom 2](http://www.globaldelight.com/boom/index.php) - "The Best Volume Booster & Equalizer For Mac"
|
||||
|
||||
## License
|
||||
|
||||
GPLv2 or later
|
||||
|
||||
|
||||
|
|
3
TODO.md
3
TODO.md
|
@ -90,3 +90,6 @@ There are also lots of other TODOs commented around the code.
|
|||
- Figure out how to test BGMDriver with Address Sanitizer enabled. It isn't working because coreaudiod will try to read
|
||||
files outside of its sandbox.
|
||||
|
||||
- Crash reporting
|
||||
|
||||
|
||||
|
|
Loading…
Add table
Reference in a new issue