Reporting a bug

Matthias Urhahn edited this page Jul 10, 2018 · 17 revisions

How to report a bug?

While it would be the perfect bug report if you follow all of the following steps you can start with basic information and still add more at a later point or on request. A bug report missing a few details is better than no bug report at all.

Step 1 - Known issues

Some bugs or issues might already be known, to check that visit the issue tracker. Check current and recently closed issues. If you find a similar issue post a comment under it, otherwise make a new issue.

Step 2 - Basics

Gather basic information about your setup, which includes

  • What kind of device you have (e.g. Nexus 5)
  • What kind of Android version and or custom ROM it's running (e.g. latest stock Android 6.0.1)
  • If your device is rooted or unrooted (e.g. Rooted with SuperSU v2.67)
  • What version of SD Maid and (if applicable) SD Maid Pro you were running (e.g. SD Maid v4.1.0, Unlocker v4.0.2)
  • Long press the settings menu entry, which will open the debug menu. At the top of the page is your install-id tap it to copy it and attach it to your bug report. This way I will be able to check for automatic crash reports from your device.

Good, now we have a baseline for what kind of device setup you have. Now add a little description describing your issue:

  • What happened?
  • What did you expect to happen?
  • What actions did you take?
  • Can you reproduce it, i.e. does this happen everytime?

Step 3 - Advanced report

The following instructions are valid for SD Maid v4.2.6+.

Crash report

If SD Maid crashed I should have gotten an automatic crash report (unless you turned that off, but why would you...). To find this crash report on my server I need to identify your SD Maid installation. This happen through a UUID which is a unique and anonymous identifier SD Maid generates on it's first start. You can find it by going into the Overview section and expanding the box containing SD Maids version information or by long pressing the settings menu entry. Tap it to copy it to your clipboard and add it to your issue ticket.

Debugrun log

If you can still open SD Maid

  1. Open SD Maid, long press Settings and click Create Debug Trigger.
  2. Now open SD Maid again and everything will be written into the log file until SD Maid is stopped
  3. When you are done just exit SD Maid and mail/upload the log file from <sdcard>/Android/data/eu.thedarken.sdm/cache/logfiles

If SD Maid is crashing while opening

  1. Force stop SD Maid.
  2. Create the file <sdcard>/Android/data/eu.thedarken.sdm/files/sdm_force_debug_run
  3. Open SD Maid again and everything will be written into the log file
  4. When you are done just exit SD Maid and mail/upload the log file from <sdcard>/Android/data/eu.thedarken.sdm/cache/logfiles

The best thing you can provide to help fix an issue is a debug log of the problem manifesting. A debug log is a very detailed description of everything SD Maid did. Note that the file may private information in form of file names and pathes on your device.

A debug run is initiated if SD Maids detects the file sdm-force-debug-run in its public cache folder. Example:


This folder is used as SD Maid can write to it without any extra permissions or requirements, thus we can use the debugrun to troubleshoot permission issues too :wink:.

If the file exists and you restart SD Maid, the file will be consumed and the current session will be a debug run. If you are unsure if SD Maid is completely shutdown, just force close it.

The trigger file can be created manually (through any file tool) or you can have SD Maid create the file for you.

The most comfortable option is having SD Maid create the file for you. This obviously only works if you can still enter SD Maid:

  • Open SD Maid
  • Open the navigation menu
  • Long press the settings entry at the bottom
  • Press the button "Create debug trigger".
  • Done. SD Maids next session will be a debug run :+1:.

The log file can be found here:


You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.