Develop and debug Python scripts on Android devices directly from VS Code. WuminPy provides a seamless development experience with real-time file sync, remote terminal access, screen mirroring, and full breakpoint debugging support.

✨ Features

🔄 Real-time File Sync

Auto-sync on save: Python files are automatically synced to your Android device when you save
Bi-directional sync: Pull all scripts from device with one command
Hot reload: Changes take effect immediately without restarting

💻 Remote Terminal

Full shell access: Connect to Android's native shell environment directly from VS Code
ANSI color support: Beautiful colored output just like a native terminal
Multi-session: Open multiple terminal instances simultaneously

📱 Screen Mirroring

Live screen view: See your Android device screen in real-time within VS Code
Touch interaction: Click and interact with the device directly from VS Code
H.264 streaming: Smooth, high-quality video streaming

🐞 Breakpoint Debugging

Full debugger support: Set breakpoints, step through code, inspect variables
VS Code integration: Uses the standard VS Code Python debugger interface
Remote debugging: Debug Python scripts running on your Android device

🚀 Quick Script Execution

One-click run: Execute current Python script on device with Ctrl+R
Instant feedback: See output in VS Code's output panel
Stop anytime: Force stop running scripts with toolbar button

📋 Requirements

Android Device

Android 8.0 (API 26) or higher
WuminPy Android app installed (companion app required)
USB debugging enabled or Wi-Fi connection

Development Machine

VS Code 1.114.0 or higher
ADB (Android Debug Bridge) installed for USB connection
Node.js (for extension development only)

🚀 Quick Start

1. Install the Extension

Install this extension from the VS Code marketplace.

2. Install Android App

Download and install the WuminPy Android app on your device.

3. Connect Your Device

USB Connection (Recommended)

Enable USB debugging on your Android device
Connect device via USB cable
Click the connection status in VS Code status bar
Select "USB 线缆连接"

Wi-Fi Connection

Open WuminPy app on your device
Note the IP address shown in the app
Click the connection status in VS Code status bar
Select "WIFI 局域网连接"
Enter the IP address

4. Start Coding!

Open a Python file in VS Code
Press Ctrl+R to run on device
Click "远程终端" in status bar to open terminal
Click "手机投屏" to view device screen

📖 Usage

Run Python Script

Open a .py file
Press Ctrl+R or use command WuminPy: 🚀 运行当前脚本 (Run)
View output in "WuminPy 控制台" output panel

Debug with Breakpoints

Set breakpoints in your Python code
Right-click in editor and select WuminPy: 🐞 断点调试当前脚本 (Debug)
Use VS Code's debug toolbar to step through code

Open Remote Terminal

Click $(terminal) 远程终端 in status bar, or
Run command WuminPy: 打开远程终端
Execute shell commands on your Android device

Screen Mirroring

Click $(device-mobile) 手机投屏 in status bar, or
Run command WuminPy: 📱 显示手机屏幕 (Show Screen)
Grant screen capture permission on device
Interact with your device screen from VS Code

Pull Scripts from Device

Run command WuminPy: 从手机拉取全部脚本 (pull) to download all scripts from device to your workspace.

⌨️ Keyboard Shortcuts

Ctrl+R - Run current Python script on device

🔧 Configuration

Remote Script Path

Configure where Python scripts are stored on the Android device:

{
  "wuminpy.remoteScriptPath": "/sdcard/pyscripts/"
}

🐛 Troubleshooting

Connection Issues

USB: Ensure USB debugging is enabled and driver is installed
Wi-Fi: Check device and computer are on same network
Firewall: Allow connections on ports 8080-8083

Terminal Not Working

Ensure WuminPy Android app is running
Try disconnecting and reconnecting
Check ADB connection: adb devices

Screen Mirroring Not Starting

Grant screen capture permission on device when prompted
Close and reopen the screen mirroring panel
Check network connection stability

📝 Release Notes

1.0.0

Initial release
Real-time file sync on save
Remote terminal with full shell access
Screen mirroring with touch interaction
Breakpoint debugging support
Quick script execution with Ctrl+R
USB and Wi-Fi connection modes

📄 License

MIT License

🤝 Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

Enjoy Android Python development! 🎉

WuminPy - Android Python Development