UPDATE THE SOFTWARE https://github.com/Xnuvers007/screenmirror-python/releases/tag/v6.1.0

📱 ScreenMirror — Display & Control Your Android Screen on Your Laptop

See and control your Android phone screen live on your laptop — via USB cable or wirelessly (WiFi)!

Supports Windows & Linux | USB / WiFi / Wireless Debugging | With Audio | Free & Open Source

---

📘 This guide is written for everyone, including those with no IT background. Follow each step slowly and carefully. If anything is confusing, read the 💡 tips below each step.

---

📖 Table of Contents

No	Section
1	What is ScreenMirror?
2	What Can You Use It For?
3	What You Need to Prepare
4	Device Compatibility
5	STEP 1: Download & Extract the Program
6	STEP 2: Enable USB Debugging on Your Phone (REQUIRED)
7	STEP 3: Install Required Tools (One-Time Setup)
8	STEP 4: Connect Your Phone to Laptop
9	Tutorial: USB Cable Connection
10	Tutorial: WiFi Connection (Wireless)
11	Tutorial: Wireless Debugging (Android 11+)
12	Tutorial: Linux Usage
13	Key Features
14	Keyboard Shortcuts While Mirroring
15	Tips to Fix Stuttering / Lag
16	Security: Is This Safe?
17	Troubleshooting Common Issues

---

🤔 What is ScreenMirror?

ScreenMirror is a program made by Xnuvers007 that lets you display your Android phone's screen live on your laptop or desktop computer.

Think of it like this: everything that appears on your phone screen will also appear on your laptop screen in real-time (instantly, with no delay). Not only that, you can also click, type, and scroll on your phone using your laptop's mouse and keyboard.

This program uses a technology called ADB (Android Debug Bridge), which is an official tool from Google/Android. It is very safe and requires absolutely no modification to your phone.

✅ No root required
✅ No special app to install on your phone
✅ Completely free
✅ High-quality output, up to 60 FPS

---

🎯 What Can You Use It For?

Use Case	Description
🎮 Play Games on a Big Screen	Enjoy mobile games on a larger monitor with keyboard & mouse control
📊 Presentations	Display your phone screen to an audience via laptop or projector
📹 Screen Recording	Save your phone screen as a high-quality MP4 video directly on your laptop
💻 Productivity	Reply to chats, open apps, transfer files — all from your laptop
🛠️ App Development	Test and debug Android apps quickly from your computer
📚 Online Classes	Share your phone screen on your laptop for Zoom/Google Meet screen sharing

---

📦 What You Need to Prepare

Before you start, make sure you have everything on this list:

Component	Minimum Requirement	Notes
Android Phone	Android 5.0 or newer	Android 9+ recommended for best performance
Windows Laptop/PC	Windows 7/8/10/11 (64-bit)	32-bit works too, but 64-bit is recommended
Linux Laptop/PC	Ubuntu 18.04+ / Debian / Mint / Kali	Debian-based distributions
USB Cable	Data cable (not charge-only)	A cable that can transfer photos to a computer ✓
Internet Connection	Minimum for initial download	Only needed once to download scrcpy
WiFi (optional)	Phone & Laptop on the same network	For wireless connection

⚠️ Important Note About USB Cable: Make sure you use a cable that can transfer data, not just one that charges. Easy test: plug your phone into the computer. If you see an option like "File Transfer" on your phone, the cable works!

---

✅ Device Compatibility

By Android Version

Android Version	Name	Features Available
Android 5.0 – 8.1	Lollipop – Oreo	⚠️ Basic only (USB screen mirror)
Android 9 – 10	Pie – Q	✅ Full (USB + WiFi + audio)
Android 11 – 12	R – S	✅ Full + cable-free Wireless Debugging
Android 13 – 15+	T – and above	✅ Full + latest video codecs (AV1)

By Phone Brand (How to Find "Build Number")

Phone Brand	Path to "Build Number"
Samsung	Settings → About Phone → Software Information → Build Number
Xiaomi / MIUI / HyperOS	Settings → About Phone → All Specs → MIUI/HyperOS Version
Poco	Settings → About Phone → MIUI Version
Oppo / ColorOS	Settings → About Phone → Build Version
Realme / Realme UI	Settings → About Phone → Build Version
Vivo / FunTouch	Settings → About Phone → Build Version
OnePlus / OxygenOS	Settings → About Phone → Build Number
Google Pixel / Stock Android	Settings → About Phone → Build Number
TECNO / Infinix / itel	Settings → About Phone → Build Number

---

📥 STEP 1: Download & Extract the Program

This step only needs to be done once.

Option A: Direct Download (Easiest for Beginners)

1. Open the main page of this repository: https://github.com/Xnuvers007/ScreenMirror

2. Find and click the green button that says <> Code (usually in the upper-right area of the page).

3. From the menu that appears, click Download ZIP.

4. Once the download is complete, open your laptop's Downloads folder.

5. Find the file named ScreenMirror-main.zip. Right-click on it.

6. Choose Extract All....

7. Click the Extract button. A new folder called ScreenMirror-main will appear.

8. Open that folder. This is where the run.bat (Windows) or run.sh (Linux) file lives.

💡 Do NOT run the program directly from inside the ZIP file! You must extract it (unzip it) into a regular folder first, then run it from there.

Option B: Using Git (For those familiar with it)

git clone https://github.com/Xnuvers007/ScreenMirror.git
cd ScreenMirror

---

🔓 STEP 2: Enable USB Debugging on Your Phone (REQUIRED)

🗣️ What is USB Debugging?
USB Debugging is a hidden feature in Android phones designed for developers. Enabling it allows your laptop to "communicate" with your phone via USB cable or WiFi. It is completely safe and does not harm your phone. You can disable it again anytime you want.

Part A: Unlock the Hidden Menu (Developer Options)

Developer Options is a hidden menu that needs to be "unlocked" first.

1. Open the Settings app (⚙️) on your phone.

2. Scroll all the way down and tap "About Phone".

3. Look for "Build Number". Refer to the table above for your specific phone brand.

4. Tap "Build Number" 7 times in a row quickly.

   • If asked for your PIN/Pattern, enter it first.
   • You'll see a countdown: "You are 3 steps away from being a developer..."

5. ✅ Done! You'll see: "You are now a developer!"

Part B: Enable USB Debugging

Now that Developer Mode is on, enable USB Debugging inside it.

1. Go back to the main Settings screen.

2. Find "Developer Options". It's usually:

   • At the very bottom of the Settings list, OR
   • Inside "System" or "Additional Settings"

3. Open Developer Options. Make sure the toggle at the top is ON (blue or green).

4. Scroll down, find "USB Debugging".

5. Tap the toggle to turn it on. A warning popup will appear.

6. Tap "OK" or "Allow" to confirm.

💡 Tip: On Samsung devices: Settings → Developer Options → Debugging → USB Debugging

Part C: Authorize Your Laptop (First Time Connection)

1. Plug your phone into your laptop using a USB cable.

2. A popup will appear on your phone: "Allow USB Debugging?"

3. Important: Check the box that says "Always allow from this computer".

4. Tap "Allow".

❓ No popup appeared? Try: Settings → Developer Options → Revoke USB Debugging Authorizations → then unplug and reconnect the cable.

---

🛠️ STEP 3: Install Required Tools (One-Time Setup)

This program needs a small application called scrcpy (pronounced "screen copy") to work. We'll download and install it automatically through the script.

Make sure your laptop is connected to the internet before starting this step.

1. Open the folder from Step 1.

2. Find the file named run.bat and double-click it to run it.

3. If a Windows warning appears (Windows Defender / UAC) saying "Windows protected your PC...", click "More info" and then "Run anyway".

   💡 This warning appears because the .bat file hasn't been run on your laptop before. This is normal and safe.

4. A black window (Command Prompt) will open. Type 2 to choose English, then press Enter.

5. The main menu will appear. Type 8 (Download & Install Dependencies), then press Enter.

6. The script will automatically check for the latest scrcpy version online. Once checked, type:

   • 1 if your laptop is 64-bit (almost all modern laptops are 64-bit)
   • 2 if your laptop is 32-bit

   💡 How to check 32 or 64-bit: Right-click "This PC" → Properties → look for "System type". If it says "64-bit operating system", type 1.

7. The download will begin. Wait until it finishes (usually 1–5 minutes depending on your internet speed).

8. Once done, press any key to return to the Main Menu.

🌟 Smart Feature: The downloaded scrcpy folder will be automatically registered to Windows Environment PATH permanently. This means your laptop can now run scrcpy from anywhere without any additional configuration!

---

🔌 STEP 4: Connect Your Phone to Laptop

Once all preparations are complete, it's time to connect your phone!

There are 3 connection methods to choose from:

Method	Best For	Quality
🔌 USB Cable	All Android phones, most stable	⭐⭐⭐⭐⭐
📡 WiFi (TCP/IP)	All Android phones, USB needed once	⭐⭐⭐⭐
📶 Wireless Debugging	Android 11+ only, 100% cable-free	⭐⭐⭐⭐

---

🔌 Tutorial: USB Cable Connection

This is the easiest and most stable method. Highly recommended for beginners!

Prerequisites: Phone connected to laptop via USB cable, and USB Debugging enabled.

1. In the ScreenMirror folder, double-click run.bat.

2. Type 2 (English) and press Enter.

3. In the Main Menu, type 1 (USB Connection) and press Enter.

4. The script will automatically detect your phone a