BackgroundMusic/MANUAL-UNINSTALL.md

<!-- 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`:<br>
  <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
  ```