Mirrors/BackgroundMusic
2
0
Fork 0
mirror of https://github.com/kyleneideck/BackgroundMusic synced 2024-09-20 06:21:54 +00:00
Code Issues Projects Releases Packages Wiki Activity
BackgroundMusic/MANUAL-UNINSTALL.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

2.1 KiB
Raw Blame History

Manual 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 killall coreaudiod

    or, if that fails

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

  • Go to the Sound section in System Settings 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 you still have the Background Music audio device, try using Terminal.app to make sure you've deleted its files:

sudo ls /Library/Audio/Plug-Ins/HAL

If you see Background Music Device.driver in the output of that command, use this command to actually delete it:

sudo rm -rf "/Library/Audio/Plug-Ins/HAL/Background Music Device.driver"

Then restart coreaudiod again. If that still doesn't work, restart your computer. If that doesn't work, feel free to open an issue. Include the output of sudo ls /Library/Audio/Plug-Ins/HAL.

Optional

  • Delete BGMXPCHelper.xpc from /usr/local/libexec or possibly /Library/Application Support/Background Music.

  • Unregister BGMXPCHelper.

    • If you're using OS X 10.11 or later:

      sudo launchctl bootout system /Library/LaunchDaemons/com.bearisdriving.BGM.XPCHelper.plist

    • If you're using an earlier version of OS X:

      sudo launchctl unload /Library/LaunchDaemons/com.bearisdriving.BGM.XPCHelper.plist

  • Delete BGMXPCHelper's launchd.plist.

    sudo rm /Library/LaunchDaemons/com.bearisdriving.BGM.XPCHelper.plist

  • Delete BGMXPCHelper's user and group.

    sudo dscl . -delete /Users/_BGMXPCHelper
sudo dscl . -delete /Groups/_BGMXPCHelper