Mirrors/BackgroundMusic
2
0
Fork 0
mirror of https://github.com/kyleneideck/BackgroundMusic synced 2024-11-10 06:34:22 +00:00
Code Issues Projects Releases Packages Wiki Activity
BackgroundMusic/MANUAL-INSTALL.md
Kyle Neideck 3097f4b621
Fix installer failing in macOS 14.5. 
`launchctl kickstart -k` is no longer permitted for `coreaudiod`. See
<https://developer.apple.com/documentation/macos-release-notes/macos-14_4-release-notes>.
(Thanks to @gchilds.)

As explained in those release notes, `kill` still works. `postinstall`
was using `killall coreaudiod` if `launchctl kickstart -k` failed, but
that was failing as well because it had to be `sudo killall coreaudiod`.

I haven't been able to reproduce this on macOS 14.4, only 14.5. Not sure
why.

See #705.
2024-04-23 15:49:13 +10:00

1.5 KiB
Raw Permalink Blame History

Manual Build and Install

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

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

  • Install the XPC helper.

    sudo xcodebuild -project BGMApp/BGMApp.xcodeproj \
                -target BGMXPCHelper \
                RUN_CLANG_STATIC_ANALYZER=0 \
                DSTROOT="/" \
                INSTALL_PATH="$(BGMApp/BGMXPCHelper/safe_install_dir.sh)" \
                clean install

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

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

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

    sudo killall coreaudiod

    or, if that fails

    sudo launchctl kickstart -kp system/com.apple.audio.coreaudiod

  • Run Background Music.app.