AirBuddy app icon

AirBuddy Logging Instructions

Thank you for your interest in helping shape the future of AirBuddy by providing great feedback. In some situations, it’s necessary to collect additional logging information than the one captured within the app itself. Follow the instructions below to set up your system for that, then reproduce the issue following the instructions provided to you and send the log files.

Step 1 - Install the configuration profile

All this profile does is to enable additional debug logging on your Mac, so that the logs that you capture are more rich, allowing me to diagnose your issue better. When the profile is installed, information about the devices you use with AirBuddy such as the names and models of the headsets might be captured. Only data related to the operation of AirBuddy will be captured, no data about other apps or personal data such as browsing history will be included. The information captured about the operation of AirBuddy is only used for the purposes of diagnosing the issue to improve AirBuddy and is destroyed after use.

If you don't feel comfortable installing the profile, or if you can't install it for policy reasons or because your user doesn't have permission to do so, you can skip this step, but keep in mind that this could hinder the diagnosis.

The profile is automatically removed after 24 hours, but feel free to manually remove it after sending the logs.

Download the AirBuddy Logging profile here.

Double-click the profile to open it in System Preferences, then click “Install" to activate it.

If you are on macOS Big Sur, you’ll need to manually launch System Preferences after opening the profile, go to the “Profiles" item and accept the profile there.

Step 2 - Collect the logs

With the profile installed, open Terminal (Applications > Utilities > Terminal) and run the following command (copy and paste it in Terminal, then press Return):

echo "Press CTRL+C when done" && log stream --level debug --color none --style syslog --predicate 'process contains "AirBuddy" OR process contains "AirBuddy Status Window" OR process contains "AirStats" OR process contains "BluetoothClassicService" OR process contains "MobileDevicesService"' > ~/Desktop/airbuddy.log Copy

While this process is running, reproduce the issue, go back to the Terminal window and press CTRL + C to stop it. There will be a file named “airbuddy.log” in your Desktop with all of the logs required.

Send that file attached as the reply to the email requesting the log collection.