WuminPy - Android Python Development

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)

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

Wi-Fi Connection

1. Open WuminPy app on your device
2. Note the IP address shown in the app
3. Click the connection status in VS Code status bar
4. Select "WIFI 局域网连接"
5. 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

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

Debug with Breakpoints

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

Open Remote Terminal

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

Screen Mirroring

1. Click $(device-mobile) 手机投屏 in status bar, or
2. Run command WuminPy: 📱 显示手机屏幕 (Show Screen)
3. Grant screen capture permission on device
4. 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

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

Screen Mirroring Not Starting

1. Grant screen capture permission on device when prompted
2. Close and reopen the screen mirroring panel
3. 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! 🎉