Mirrors/BackgroundMusic
2
0
Fork 0
mirror of https://github.com/kyleneideck/BackgroundMusic synced 2024-11-10 14:44:14 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description
9 commits 6 branches 63 tags 2.5 MiB
C++ 60.8%
Objective-C 16%
Objective-C++ 11.7%
C 5.9%
Shell 4.9%
Other 0.6%
Find a file
Kyle Neideck 33b6b17115 Add an XPC helper. Sync BGMApp and BGMDriver with it while starting IO. 
The BGMApp project now builds an XPC service bundle called BGMXPCHelper,
which vends a Mach service that BGMApp and BGMDriver can use to
communicate. This will hopefully be useful for some of the tasks HAL
notifications aren't suited to.

In this commit, BGMDriver uses the XPC helper when starting IO, to wait
until BGMApp is ready for playthrough. BGMApp can only start playthrough
when the output hardware is ready for IO. BGMDriver can now tell the HAL
when we're ready for IO, which means we don't have to keep the output
hardware running all the time (or drop frames or increase latency).

The end result is that playthrough doesn't waste CPU time while idle any
more. This also means that now playthrough won't prevent the system from
sleeping when idle.
2016-03-31 11:42:24 +11:00
BGM.xcworkspace Initial commit 2016-02-19 16:25:34 +11:00
BGMApp Add an XPC helper. Sync BGMApp and BGMDriver with it while starting IO. 2016-03-31 11:42:24 +11:00
BGMDriver Add an XPC helper. Sync BGMApp and BGMDriver with it while starting IO. 2016-03-31 11:42:24 +11:00
Images Initial commit 2016-02-19 16:25:34 +11:00
SharedSource Add an XPC helper. Sync BGMApp and BGMDriver with it while starting IO. 2016-03-31 11:42:24 +11:00
.gitignore Initial commit 2016-02-19 16:25:34 +11:00
CONTRIBUTING.md Fix various Markdown bugs 2016-02-24 19:14:12 +11:00
DEVELOPING.md Add an XPC helper. Sync BGMApp and BGMDriver with it while starting IO. 2016-03-31 11:42:24 +11:00
LICENSE Initial commit 2016-02-19 16:25:34 +11:00
README.md Fix various Markdown bugs 2016-02-24 19:14:12 +11:00
TODO.md Add an XPC helper. Sync BGMApp and BGMDriver with it while starting IO. 2016-03-31 11:42:24 +11:00

README.md

Background Music

OS X audio utility

  • Automatically pauses your music player when other audio starts playing and unpauses it afterwards
  • Per-application volume, boost quiet apps
  • Record system audio

  • 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).

Requires OS X 10.10+. Might work on 10.9, but I haven't tried it.

Auto-pause music

Background Music can pause your music player app when other audio starts playing and unpause it afterwards. The idea is that when I'm listening to music and pause it to watch a video or something I always forget to unpause it afterwards. So this keeps me from wearing headphones for hours listening to nothing.

So far only iTunes, Spotify and VLC are supported, but adding support for a music player should only take a few minutes (see BGMMusicPlayer.h). If you don't know how to program, or just don't feel like it, create an issue and I'll try to add it for you.

App volumes

Background Music has a volume slider for each app running on the system. I mostly use this to boost quiet apps above their normal maximum volume.

Recording system audio

With Background Music running, open QuickTime Player and go File > New Audio Recording... (or movie/screen). Then click the arrow next to the record button that looks like ⌄ and select Background Music Device as the input device.

You should be able to record system audio and a microphone together by creating an aggregate device that combines your input device (usually Built-in Input) with Background Music Device. You can create the aggregate device using the Audio MIDI Setup utility from /Applications/Utilities.

Install

No binaries yet, but building only takes a few seconds.

  • Install the virtual audio device Background Music Device.driver to /Library/Audio/Plug-Ins/HAL.

    sudo xcodebuild -project BGMDriver/BGMDriver.xcodeproj -target "Background Music Device" DSTROOT="/" install RUN_CLANG_STATIC_ANALYZER=0

  • Install Background Music.app to /Applications (or wherever).

    xcodebuild -project BGMApp/BGMApp.xcodeproj -target "Background Music" DSTROOT="/" install RUN_CLANG_STATIC_ANALYZER=0

  • Restart coreaudiod:
    (Audio will stop working until the next step, so you might want to pause any running audio apps.)

    sudo launchctl unload /System/Library/LaunchDaemons/com.apple.audio.coreaudiod.plist
sudo launchctl load /System/Library/LaunchDaemons/com.apple.audio.coreaudiod.plist

  • Run Background Music.app.

Uninstall

  • Delete Background Music.app from /Applications.

  • Delete Background Music Device.driver from /Library/Audio/Plug-Ins/HAL.

  • Pause apps that are playing audio, if you can.

  • Restart coreaudiod: [//]: # ( (Open /Applications/Utilities/Terminal.app and paste the following at the prompt.) )

    sudo launchctl unload /System/Library/LaunchDaemons/com.apple.audio.coreaudiod.plist
sudo launchctl load /System/Library/LaunchDaemons/com.apple.audio.coreaudiod.plist

  • 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 have stopped working or just restart your system.)

Troubleshooting

If Background Music crashes and system audio stops working, open the Sound panel in System Preferences and change your system's default output device to something other than Background Music Device. If it already is, it might help to change the default device and then change it back again. Failing that, you might have to uninstall.

Known issues

  • VLC automatically pauses iTunes/Spotify when it starts playing something, but that stops Background Music from unpausing your music afterwards. To workaround it, open VLC's preferences, click Show All, go Interface > Main interfaces > macosx and change Control external music players to either Do nothing or Pause and resume iTunes/Spotify.

    Similarly, Skype pauses iTunes during calls. If you want to disable that, uncheck Pause iTunes during calls on the General tab of Skype's preferences.

  • Plugging in or unplugging headphones when Background Music isn't running can silence system audio. To fix it, go to the Sound section in System Preferences, click the Output tab and change your default output device to something other than Background Music Device.

    This happens when OS X remembers that Background Music Device was your default audio device the last time you last used (or didn't use) headphones.

  • A recent Chrome bug 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.

  • Plenty more. Some are in listed in TODO.md.

Related projects

  • Core Audio User-Space Driver Examples The sample code from Apple that BGMDriver's based on.
  • Soundflower - "MacOS system extension that allows applications to pass audio to other applications."
  • WavTap - "globally capture whatever your mac is playing—-as simply as a screenshot"
  • llaudio - "An old piece of work to reverse engineer the Mac OSX 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, GitHub (Windows) - Auto-pause music
  • Sound Siphon (non-free) - System/app audio recording, per-app volumes, system audio equaliser
  • Jack OS X - "A Jack audio connection kit implementation for Mac OS X"
  • PulseAudio OS X - "PulseAudio for Mac OS X"
  • eqMac - "System-wide Audio Equalizer for Mac OSX"
  • Zirkonium - "An infrastructure and application for multi-channel sound spatialization on MacOS X."

License

GPLv2 or later