Bugs

Bugs

🐌 🦋 🐛 🐜 🐝 🐞

Bugs are part of an apps life. They mean you no harm, but they are not here to stay either 😠.

What are bugs?

• If the app crashes it is obviously a bug
• If something is behaving unexpectedly, it could be a bug.

In any case check that you are on the latest update, the bug might already be fixed.

If the bug isn't fixed, then report it 😁.

Reporting a bug

Create an issue ticket on GitHub: https://github.com/d4rken/bluemusic/issues

• Describe what you expected and what actually happened
• List the steps that someone else would have to take to reproduce the issue
• Describe your setup
  • Your device type (e.g. Pixel 5)
  • Android version (e.g. Android 13.1)
  • The BVM version you're using

Include a debug log if you can reproduce the issue.

Hint: You can long press the "Changelog" entry in BVM's settings to copy the version to your clipboard.

Debug log

A debug log is a recording of BVM's actions. You start the recording, reproduce the issue, then stop it and can share a text file with a chronological account of what BVM did.

To start recording a debug log:

• Go to settings in BVM by navigating to the Settings tab
• Find the Support entry in the settings list
• Tap Debug log on the support screen
• The debug log will start recording (you'll see "Currently recording" status)
• Now reproduce the issue you want to record
• Once you have reproduced the issue, go back to Settings → Support → Debug log
• Tap to stop recording
• After a short moment you will get options to share the log file

The debug log will be recorded until you stop it, the recording will continue, even if you force-stop and restart BVM.

If you are troubleshooting issues related to Bluetooth connections or volume restoration, it is useful to:

1. Start debug logging
2. Disconnect your Bluetooth device
3. Wait a few seconds
4. Reconnect the device
5. Wait for BVM to react (or not react)
6. Stop the debug log

The debug log files contain sensitive information (e.g. device names, Bluetooth MAC). Only share them with trusted parties (e.g. the developer when troubleshooting an issue).

What to include when reporting bugs

A good bug report includes:

1. Clear description: What you expected vs what happened
2. Steps to reproduce: Exact steps someone else can follow
3. Device info:
   • Phone model
   • Android version
   • BVM version
   • Whether you're using Free or Pro version
4. Bluetooth device info:
   • Type of device (headphones, car stereo, speaker, etc.)
   • Device name/model if known
5. Debug log: If you can reproduce the issue
6. Screenshots: If relevant to the issue

Common issues to check first

Before reporting a bug, check if:

• You're on the latest version of BVM
• The app has all required permissions
• Battery optimization isn't preventing BVM from running
• The Bluetooth device is properly paired
• You've configured the device in BVM (not just connected it)
• The timing settings are appropriate for your device

Remember: The more information you provide, the easier it is to fix the bug! 🎯