Back to Backgroundmusic

Manual Uninstall

MANUAL-UNINSTALL.md

0.4.32.1 KB
Original Source
<!-- vim: set tw=120: -->

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:

    <sup>(Open /Applications/Utilities/Terminal.app and paste the following at the prompt.)</sup>

    shell
    sudo killall coreaudiod
    

    or, if that fails

    shell
    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:

shell
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:

shell
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:

      shell
      sudo launchctl bootout system /Library/LaunchDaemons/com.bearisdriving.BGM.XPCHelper.plist
      
    • If you're using an earlier version of OS X:

      shell
      sudo launchctl unload /Library/LaunchDaemons/com.bearisdriving.BGM.XPCHelper.plist
      
  • Delete BGMXPCHelper's launchd.plist.

    shell
    sudo rm /Library/LaunchDaemons/com.bearisdriving.BGM.XPCHelper.plist
    
  • Delete BGMXPCHelper's user and group.

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