From 3aebd4cd1cea0d5531f228787052d28e88ab26ea Mon Sep 17 00:00:00 2001
From: devthejo <devthejo@protonmail.com>
Date: Thu, 10 Jul 2025 07:28:33 +0200
Subject: [PATCH] docs: adb udev rules

---
 docs/android-install.md | 69 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)

diff --git a/docs/android-install.md b/docs/android-install.md
index 34dcae9..aa01246 100644
--- a/docs/android-install.md
+++ b/docs/android-install.md
@@ -97,3 +97,72 @@ You can run this script directly:
 export DEVICE=emulator-5554
 ./install-android.sh
 ```
+
+# enable USB debug mode
+
+Add udev rules for your device
+
+1. First, find your device's vendor ID:
+
+```sh
+lsusb
+```
+
+Look for your phone manufacturer (e.g., Google, Samsung, OnePlus). Note the ID like 18d1:4ee7
+
+2. Create/edit the udev rules file:
+
+```sh
+sudo micro /etc/udev/rules.d/51-android.rules
+```
+
+3. Add a line for your device. Here are common manufacturers:
+
+```
+# Google
+SUBSYSTEM=="usb", ATTR{idVendor}=="18d1", MODE="0666", GROUP="plugdev"
+# Samsung
+SUBSYSTEM=="usb", ATTR{idVendor}=="04e8", MODE="0666", GROUP="plugdev"
+# OnePlus
+SUBSYSTEM=="usb", ATTR{idVendor}=="2a70", MODE="0666", GROUP="plugdev"
+# Xiaomi
+SUBSYSTEM=="usb", ATTR{idVendor}=="2717", MODE="0666", GROUP="plugdev"
+```
+
+4. Set proper permissions and reload rules:
+
+```sh
+sudo chmod a+r /etc/udev/rules.d/51-android.rules
+sudo udevadm control --reload-rules
+sudo service udev restart
+```
+
+5. Add yourself to the plugdev group:
+
+```sh
+sudo usermod -aG plugdev $USER
+```
+
+Force the authorization prompt
+
+1. Kill adb server:
+
+```sh
+adb kill-server
+```
+
+2. Unplug your device
+3. On your phone:
+  - Go to Developer options
+  - Revoke USB debugging authorizations
+  - Toggle USB debugging OFF then ON
+
+4. Plug the device back in
+5. Start adb with proper permissions:
+
+```sh
+adb start-server
+adb devices
+```
+
+6. The authorization prompt should now appear on your phone
\ No newline at end of file