README.md

# ForceScreencast

ForceScreencast is a utility toolkit designed to help users recover control of an Android phone with a dead or broken screen (black screen), even if "USB Debugging" is initially disabled.

## Features

*   **OTG Control**: Use your computer's keyboard and mouse to control the phone blindly (imitating a physical keyboard/mouse connection).
*   **Automated Enablement**: Script (`macro_enable_adb.ps1`) to automatically navigate to Settings and enable USB Debugging.
*   **Blind Navigation Guide**: Detailed tips on how to navigate Android without seeing the screen.
*   **Full Screencast**: Once enabled, fully mirror and control the device using scrcpy.

## Prerequisites

*   Windows PC.
*   USB Cable to connect the phone.
*   **Zadig**: Tool for replacing USB drivers (Required for OTG mode).
*   **scrcpy**: The scripts are configured for `C:\Users\User\Desktop\scrcpy\scrcpy-win64-v3.3.4`. If you have it elsewhere, edit strict paths in the `.ps1` files.

---

## Recovery Guide

### Phase 1: Driver Setup (Crucial)

You must change your phone's USB driver for the "Blind" generic mouse/keyboard tool to work. Standard ADB drivers do not work for this mode.

1.  Download **Zadig** (https://zadig.akeo.ie/).
2.  Connect your phone via USB.
3.  Open **Zadig**.
4.  Click **Options** -> **List All Devices**.
5.  Select your phone in the dropdown. (Name might be "Samsung", "Pixel", "Gadget Serial", or "Android").
6.  Look at the Driver box on the right.
    *   **Goal**: Change it to **WinUSB**.
    *   Click **Replace Driver** (or Install Driver).
    *   Wait for it to finish.

**Status Check**: Now your computer can "talk" to the phone as a Keyboard/Mouse. It CANNOT do normal ADB/File Transfer yet.

### Phase 2: Run the Automation

You can either manually control the phone or use the included macro script.

**Option A: Automated Script (Recommended)**
1.  Double-click `run_macro.bat`.
2.  **Manual Part**: The script will launch a black window and PAUSE.
    *   **Unlock** your phone manually (Spacebar to wake, Swipe Up with mouse, Type Password/PIN).
    *   **Open Settings** manually (or ensure you are on the Home Screen).
3.  **Automated Part**:
    *   Once enabled, click the script window and Press **ENTER**.
    *   **Hands Off!** The script will attempt to:
        *   Swipe up and find Settings.
        *   Enable Developer Mode (build number clicks).
        *   Find Developer Options.
        *   Enable USB Debugging.
        *   Accept the "Allow USB Debugging?" popup (Right Arrow -> Enter).

**Option B: Manual OTG Control**
1.  Double-click `run_OTG.bat`.
2.  Use your keyboard and mouse to navigate blindly.
    *   **Wake**: Spacebar.
    *   **Unlock**: Click and Drag mouse UP. Type PIN.
    *   **Navigate**: Arrow keys, Enter, Esc (Back).

### Phase 3: Reset Drivers (Required for Screencast)

Now that USB Debugging is ON, you must switch the driver BACK so the Screencast app (ADB) can see the screen.

1.  **Close** any running script windows.
2.  Open **Device Manager** on your PC.
3.  Locate your device (likely under "Universal Serial Bus devices" because we made it WinUSB).
4.  **Right-Click** your device -> **Uninstall Device**.
    *   Check the box **"Attempt to remove the driver for this device"**.
    *   Click **Uninstall**.
5.  **Unplug** your phone.
6.  **Replug** your phone. Windows should automatically reinstall the "Original" driver (MTP/ADB).

### Phase 4: Start Screencast

1.  Double-click `run_screencast.bat`.
2.  You should now see your phone screen mirrored on your PC.

---

## Blind Navigation Tips

Navigating a phone with a dead screen is difficult. Here are tricks to help you find your way.

### The "Golden Ticket": TalkBack
If you can enable TalkBack (Screen Reader), the phone will **tell you** what you are selecting.
*   **Shortcut**: Press `Win+Alt+Enter` (sometimes `Ctrl+Alt+Enter` or Hold `Volume Up + Volume Down` for 3 seconds).
*   **If enabled**: You will hear "TalkBack On".
*   **Navigation changes**:
    *   Use `Alt+Right` / `Alt+Left` to move focus.
    *   Use `Alt+Enter` to click.

### Common Keyboard Shortcuts
*   **Wake Up**: Press `Space` or `Power Key`.
*   **Unlock**:
    *   Swipe Up: Drag mouse up OR press `Space` then `Tab` then `Enter`.
    *   PIN: Type numbers on Numpad. Enter.
*   **Go Home**: `Win+Enter` or `Esc` multiple times.
*   **Notifications**: `Win+N`.
*   **Settings**: `Win+N`, then Right Arrow until you hit the gear icon.

### Use Sound
Turn your volume UP.
*   **Lock/Unlock sounds** indicate if the phone is awake.
*   **Charging sound** confirms USB connection.
*   **Screenshot sound** (`PrintScreen`) confirms the phone is on.

### Navigating Settings Blindly (Generic Android)
1.  **Open Settings**: Trigger Assistant (`Win`) and type "Open Developer Options" or "Open Settings".
2.  **Scroll to Bottom**: Press `End` key. ("About Phone" is usually at the bottom).
3.  **Enter "About Phone"**: Press `Up Arrow` once or twice, then `Enter`.
4.  **Find Build Number**: Press `End` (bottom), then `Enter` 7 times to enable Developer Mode.
5.  **Go Back**: `Esc`.
6.  **Find Developer Options**: It is often above "About Phone" or inside "System". Try `Up Arrow` -> `Enter`.
7.  **Enable USB Debugging**:
    *   Scroll down (Down Arrow x5-10).
    *   One of the items is the toggle. Press `Enter`.
    *   **The Trap**: A popup appears "Allow USB Debugging?".
    *   Press `Tab` (or Right Arrow) to move focus to "Allow/OK".
    *   Press `Enter`.

## Troubleshooting

*   **Script types PIN but phone doesn't unlock?** Timing might be off. Try manually unlocking before running the script.
*   **"USB Device not found"?** You likely didn't perform Phase 1 (Zadig Driver Switch) or the driver reverted.
*   **"Device Unauthorized"?** The automation failed to click "Allow" on the popup. Retry the process (Remember to switch drivers back and forth!).