# How to Report Bugs / Take Logs ## Rules \- Bug reports must be on an **UNMODIFIED** system.\ \- **No Magisk / KernelSU / any root.** Reports with root will be ignored. ## Prerequisites \- ADB and Fastboot **v33 or newer** ([Platform-Tools](https://developer.android.com/tools/releases/platform-tools))\ \- USB debugging enabled\ \- If you don't know how to set this up, ask any LLM (ChatGPT, Claude, Gemini, etc.) to guide you. ## 1. Logcat from boot (required for any system bug) 1\. Turn the phone off and connect it to the PC\ 2\. Run: ``` adb wait-for-device logcat -b all > logcat.txt ``` 3\. Power on the phone. Logging starts at the Google logo.\ 4\. Reproduce the bug, then press `Ctrl + C` ## 2. Dmesg (right after the bug happens) ``` adb shell dmesg > dmesg.txt ``` Send **both** `logcat.txt` and `dmesg.txt`. ## 3. Black screen + not on ADB The phone is probably in EDL mode. Take a memory dump using [bkerler/edl](https://github.com/bkerler/edl): ``` edl memorydump ``` This creates a `memory` folder. Send that whole folder. ## 4. Visual bugs Also attach a screen recording (or a video from another phone if it can't be screen-recorded). ## When reporting, include \- ROM version / build date\ \- What went wrong + steps to reproduce\ \- Logs as **files** (no screenshots, no pasted text)\ \- Screen/video recording for visual bugs ## Privacy Logs can contain sensitive info. If you're worried about that, send them to my DM instead of the group. **No logs = no fix.**