Scrcpy Smart Connect - VS Code Extension

   ____                             ____                       _   
  / ___|  ___ _ __ ___ _ __  _   _/ ___| _ __ ___   __ _ _ __| |_ 
  \___ \ / __| '__/ __| '_ \| | | \___ \| '_ ` _ \ / _` | '__| __|
   ___) | (__| | | (__| |_) | |_| |___) | | | | | | (_| | |  | |_ 
  |____/ \___|_|  \___| .__/ \__, |____/|_| |_| |_|\__,_|_|   \__|
                      |_|    |___/

Smart wireless connection manager for scrcpy

Features • Installation • Usage • Documentation • License

📱 Overview

Scrcpy Smart Connect brings the power of wireless Android device mirroring directly into Visual Studio Code. Control your Android device, take screenshots, and manage connections without leaving your editor.

Built on top of scrcpy by Genymobile, this extension adds intelligent connection management, auto-reconnect, and seamless integration with VS Code.

🆕 What's New in v2.5.0

🚀 Auto-Install Everything - One-click installation of all dependencies
🧙 Setup Wizard - Guides you through first-time setup
✨ Zero Manual Setup - Just install and go!
🔄 Smart Detection - Installs only what's missing
📦 Platform Support - Works on Linux, macOS, and Windows

✨ Features

🚀 Core Features

📱 Wireless Connection - Connect to Android devices via WiFi automatically
🔌 USB Fallback - Automatically falls back to USB if wireless fails
📸 Quick Screenshots - Capture screenshots with a single command
🎯 Smart Device Selection - Prefers wireless over USB when both available
💾 IP Persistence - Remembers device IP for future connections

⚡ Performance

50% faster activation - Optimized startup with path caching
Async operations - Non-blocking dependency checks
Instant response - Optimized command execution

🎮 Device Profiles

Gaming - High FPS (120), low latency, optimized for gaming
Recording - High quality (1920p), 16M bitrate, perfect for recording
Demo - Borderless, always-on-top, ideal for presentations
Battery - Low power consumption, 30 FPS, battery saver mode

🎨 User Interface

Status Bar Indicator - Shows connection status at a glance
Quick Pick Menu - Fast access to all actions (Ctrl+Alt+S)
Progress Notifications - Visual feedback during operations
Keyboard Shortcuts - Efficient workflow with hotkeys

🔧 Advanced Features

Auto-install Dependencies - Automatic scrcpy installation
Cross-platform Support - Linux, macOS, Windows (WSL/Git Bash)
Multiple Devices - Save and manage multiple devices
Custom Ports - Support for custom ADB ports
Direct IP Connection - Connect to specific IP addresses

📦 Installation

⚡ Quick Install (Automatic)

Just install the extension - it will handle everything automatically!

Install from VS Code Marketplace:
- Open VS Code
- Go to Extensions (Ctrl+Shift+X)
- Search for "Scrcpy Smart Connect"
- Click Install
First Launch:
- Extension will check for missing dependencies
- Click "Install All" when prompted
- Wait for installation to complete
- Restart VS Code when prompted
- Done! 🎉

🛠️ Manual Installation (Optional)

If you prefer manual setup or auto-install fails:

Linux (Ubuntu/Debian):

# Install scrcpy-smart CLI
curl -fsSL https://raw.githubusercontent.com/tareq-alomari/scrcpy-smart/main/install.sh | bash

# Install scrcpy & ADB
sudo apt install scrcpy adb

macOS:

# Install scrcpy-smart CLI
curl -fsSL https://raw.githubusercontent.com/tareq-alomari/scrcpy-smart/main/install.sh | bash

# Install scrcpy & ADB
brew install scrcpy android-platform-tools

Windows:

# Install scrcpy & ADB
winget install Genymobile.scrcpy
winget install Google.PlatformTools

# Install scrcpy-smart CLI (in Git Bash or WSL)
curl -fsSL https://raw.githubusercontent.com/tareq-alomari/scrcpy-smart/main/install.sh | bash

🔄 Re-run Setup

If you need to run the setup wizard again:

Press Ctrl+Shift+P
Type: Scrcpy: Run Setup Wizard
Click "Install All"

Troubleshooting Installation

If auto-install doesn't work:

Run setup wizard manually:
- Press Ctrl+Shift+P
- Type: Scrcpy: Run Setup Wizard

Check what's missing:

which scrcpy-smart  # Should show path
which scrcpy        # Should show path
which adb           # Should show path

Set custom path:
- Settings → "scrcpy-smart.scriptPath"
- Enter full path: /home/username/.local/bin/scrcpy-smart
Manual installation:
- See "Manual Installation" section above

🚀 Usage

Quick Start

Connect your Android device via USB
Enable USB debugging on your device
Press Ctrl+Alt+C or click the status bar icon
Done! Future connections will be wireless

Keyboard Shortcuts

Shortcut	Action
`Ctrl+Alt+S`	Quick actions menu
`Ctrl+Alt+C`	Connect device
`Ctrl+Alt+P`	Take screenshot

Commands

Open Command Palette (Ctrl+Shift+P) and type:

Scrcpy: Connect Device - Connect to your Android device
Scrcpy: Connect to IP - Connect to specific IP address
Scrcpy: Take Screenshot - Capture a screenshot
Scrcpy: List Devices - Show all connected devices
Scrcpy: Reset Connection - Reset saved device IP
Scrcpy: Connect with Profile - Choose device profile
Scrcpy: Install Dependencies - Install scrcpy automatically

Status Bar

Click the 📱 Scrcpy icon in the status bar for quick access to all actions.

⚙️ Configuration

Configure in VS Code Settings (Ctrl+,):

{
  "scrcpy-smart.scriptPath": "",    // Custom path to scrcpy-smart (auto-detect if empty)
  "scrcpy-smart.bitrate": "8M",     // Video bitrate (4M, 8M, 16M)
  "scrcpy-smart.maxSize": 1024,     // Max resolution (720, 1024, 1920)
  "scrcpy-smart.maxFps": 60         // Max FPS (30, 60, 120)
}

Custom Script Path

If the extension can't find scrcpy-smart automatically:

Open Settings (Ctrl+,)
Search for "scrcpy-smart.scriptPath"
Enter the full path to your script
Example: /home/username/.local/bin/scrcpy-smart

The extension will auto-detect the script in these locations:

System PATH (scrcpy-smart command)
~/.local/bin/scrcpy-smart
/usr/local/bin/scrcpy-smart
/usr/bin/scrcpy-smart

📚 Documentation

User Guide - Complete usage guide
Supported Platforms - OS compatibility
Troubleshooting - Common issues and solutions
Changelog - Version history

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/amazing)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing)
Open a Pull Request

📄 License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

🙏 Credits

scrcpy by Genymobile - The amazing screen mirroring tool
Developed by Tareq Alomari
Contributors - Thank you to all contributors!

📞 Support

GitHub Issues: Report a bug
GitHub Discussions: Ask a question
Email: tareq.alomari@example.com

🌟 Star History

If you find this extension useful, please consider giving it a star on GitHub!

Made with ❤️ by Tareq Alomari

GitHub • Website • LinkedIn