🔥 The Most Advanced Android Screen Lock BruteForce Tool with Mobile Timer Auto-Detection 🔥

---

📋 Table of Contents

• ✨ Features
• 📦 Requirements
• ⚡ Installation
• 🚀 Usage
• ⚙️ Configuration
• 🧠 How Timer Auto-Detect Works
• 📸 Screenshots
• ⚠️ Disclaimer
• ☕ Support / Donate
• 👨‍💻 Author

---

✨ Features

Feature	Description
🎯 Mobile Timer Auto-Detect	Reads lockout timer from screen (e.g. "Try again in 30 seconds", "30 सेकंड") and waits EXACTLY that long with live countdown
⌨️ Digit-by-Digit Precision	Each digit entered separately with microsecond gaps — 100% skip/mix bug fixed
🔓 System Lockscreen Attack	Wordlist or PIN brute force (4/5/6/8 digit)
📱 App Lockscreen Attack	Brute force in-app locks (Option 8)
🎮 Screen Test & App Test	Calibrate keypad positions visually before attacking
📊 Live Progress Display	Real-time current password, speed (tries/sec), attempt count
🛡️ Device Auto-Pause	Detects USB disconnect, pauses attack automatically
💾 Auto-Save Results	Found password saved to file with timestamp
🌐 Multi-Language Timer Detection	English + Hindi ("seconds", "secs", "सेकंड")
⚡ Lightning Fast	Optimized ADB command batching for maximum speed

---

📦 Requirements

Software

• Python 3.7+ — Download
• ADB (Android Debug Bridge) — Must be accessible via one of:
  • adb in system PATH
  • C:\platform-tools\adb.exe
  • C:\Users\admin\Downloads\platform-tools-latest-windows\platform-tools\adb.exe
  • ~/.android/sdk/platform-tools/adb.exe
  • %LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe

Hardware

• Android Device (phone/tablet)
• USB Cable (data cable, not charge-only)
• Windows / Linux / macOS host machine

Phone Setup (MANDATORY)

1. Enable Developer Options: Settings → About Phone → Tap "Build Number" 7 times
2. Enable USB Debugging: Settings → Developer Options → USB Debugging ON
3. Connect via USB → Phone shows "Allow USB Debugging?" → Tap ALLOW ✅
4. Verify: Run adb devices — should show device (not unauthorized)

---

⚡ Installation

Option 1: Direct Run (Recommended — No Install)

git clone https://github.com/technicalsuraj2/rootlock.git
cd rootlock
python rootlock.py

Option 2: Install as Global Command

git clone https://github.com/technicalsuraj2/rootlock.git
cd rootlock
pip install -e .
# Now run from anywhere:
rootlock

Option 3: Download Single File

curl -O https://raw.githubusercontent.com/technicalsuraj2/rootlock/main/rootlock.py
python rootlock.py

---

🚀 Usage

Quick Start

python rootlock.py

First Time Setup (IMPORTANT)

Step	Action	Menu Option
1	Connect phone, USB Debugging ON	—
2	Calibrate System Keypad	Option 6 → Follow on-screen taps
3	Calibrate App Keypad (if needed)	Option 7 → Follow on-screen taps
4	Start Attack	Option 1, 2-5, or 8

Attack Modes

Option	Mode	Description
1	Wordlist Attack	Your custom password file (one per line)
2	4-Digit PIN	0000 → 9999 (10,000 combos)
3	5-Digit PIN	00000 → 99999 (100,000 combos)
4	6-Digit PIN	000000 → 999999 (1,000,000 combos)
5	8-Digit PIN	00000000 → 99999999 (100M combos)
6	Screen Test	Calibrate system lockscreen keypad
7	App Screen Test	Calibrate in-app lockscreen keypad
8	App Pass BruteForce	Wordlist attack on app lock
9	GitHub	Open author's GitHub
0	Exit	Quit tool

Wordlist Format (passwords.txt)

1234
0000
123456
password
1111
admin
12345
000000

One password per line. Tool tries exact order, line by line.

---

⚙️ Configuration

Edit top of rootlock.py to tune:

# ⚡ ATTACK SPEED (lower = faster, too low = errors)
ATTACK_DELAY = 0.02       # Delay between password attempts
DIGIT_GAP    = 0.04       # Gap between each digit (CRITICAL for reliability)
CLEAR_SETTLE = 0.08       # Wait after clearing field
ENTER_SETTLE = 0.15       # Wait after pressing ENTER

# 🔍 TIMER DETECTION
TIMER_CHECK_EVERY = 2     # Check screen for timer every N attempts (1 = every attempt)

# 📐 KEYPAD POSITIONS (screen % — adjust if taps miss)
KP_ROWS = [0.62, 0.70, 0.78, 0.86]   # System lockscreen rows (Y%)
KP_COLS = [0.25, 0.50, 0.75]         # System lockscreen cols (X%)
APP_KP_ROWS = [0.62, 0.70, 0.78, 0.86]  # App lockscreen rows
APP_KP_COLS = [0.25, 0.50, 0.75]         # App lockscreen cols

Keypad Layout (Don't Change)

KP_LAYOUT = {
    "1": (0,0), "2": (1,0), "3": (2,0),
    "4": (0,1), "5": (1,1), "6": (2,1),
    "7": (0,2), "8": (1,2), "9": (2,2),
    "0": (1,3),
}

---

🧠 How Timer Auto-Detect Works

┌─────────────────────────────────────────────────────────────┐
│  1. Every TIMER_CHECK_EVERY attempts                        │
│  2. Dump screen UI via: uiautomator dump                    │
│  3. Parse XML for timer patterns:                           │
│     • "Try again in 30 seconds"                             │
│     • "30 सेकंड प्रतीक्षा करें"                              │
│     • "Wait 30 sec"                                         │
│     • "29 s"                                                │
│  4. If found → PAUSE exactly that many seconds              │
│  5. Live countdown on screen: "WAITING: 30 sec"             │
│  6. Timer ends → Auto-resume next password                  │
│  7. Fallback: No timer after 5 fails → Wait 30 sec default  │
└─────────────────────────────────────────────────────────────┘

Why it's better: Other tools use fixed 30s wait. ROOTLOCK reads the actual timer on your screen — if phone says "Try again in 12 seconds", it waits 12s, not 30s. Massive time savings!

---

📸 Screenshots

Replace placeholder images with actual screenshots

---

⚠️ Disclaimer

⚖️ FOR EDUCATIONAL AND AUTHORIZED TESTING ONLY

This tool is designed for:

• Security researchers testing their own devices
• Authorized penetration testing with written permission
• Learning about Android lockscreen vulnerabilities
• Recovery of your own forgotten PIN/password

DO NOT USE ON DEVICES YOU DON'T OWN OR HAVE EXPLICIT PERMISSION TO TEST. Unauthorized access to devices is illegal under most jurisdictions.

The author (Suraj Patel) is not responsible for any misuse or damage caused by this tool.

---

☕ Support / Donate

If ROOTLOCK saved you time or helped your research, consider buying me a coffee ☕
_{Every donation fuels late-night coding sessions 🌙}

💰 Crypto Donations (USDT - TRC20)

TBnsqWuvdhm7HDyhozF1ZspnX58GGaM6no

_{💚 Thank you for your support! Every satoshi counts 💚}

---

👨‍💻 Author

Suraj Patel 🇮🇳
_{Security Researcher • Android Enthusiast • Open Source Contributor}

---

Made with ❤️ and lots of ☕ by Suraj Patel
_{If this tool helped you, please ⭐ the repo — it means the world!}