BackgroundMusic/MANUAL-UNINSTALL.md
Lawrence Warren ca3c497940
feat(docs): Update references to System Preferences
As of MacOS 13, System Preferences is known as System Settings. This
commit updates all user facing references to System Preferences, using
the new nomenclature.
2022-11-26 12:52:44 +11:00

2.1 KiB

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 launchctl kickstart -kp system/com.apple.audio.coreaudiod
    

    or, if that fails

    sudo killall 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