Scrcpy-Sidebar - A Sidebar Toolbox of Scrcpy

A sidebar toolbox of Scrcpy / Scrcpy的侧边工具箱

English(Current) | 中文帮助

demo video on Bilibili

Enhance your scrcpy experience with audio forwarding and virtual buttons!

✨ Features

• 🔊 Audio Forwarding for Android 10+
  Built-in sndcpy support (No VLC required)

• 🎮 Virtual Control Panel

  • Virtual buttons with long-press support
  • Customizable layout via GUI and JSON config
  • Real-time updates without restart

• ⚙️ Convenience Tools

  • Keep screen awake (auto-restore settings)
  • Chinese punctuation auto-correction

📦 Quick Start

1. Prerequisites

   • scrcpy installed
   • Android device with USB debugging enabled

2. Installation
   Just Download Here

3. Configuration
   Edit config.json:

   • Windows at %APPDATA%/Scrcpy-Sidebar/config.json
   • Linux at ~/.config/scrcpy-sidebar/config.json

   Default json:

   {
    "adbPath": "adb.exe",
    "deviceSerial": "",
    "note": "请尽量从GUI更改配置, 不合适的修改可能导致错误。Try to change the configuration from the GUI. Inappropriate modifications may cause errors.",
    "sndcpyApkPath": "sndcpy.apk",
    "sndcpyPort": 28200,
    "wndInfoOfAdvancedKeyboard": {
        "buttons": {
            "HOME": "HOME"
        },
        "height": 47,
        "width": 259
    }

🛠️ Advanced Usage

• Adding Custom Buttons

  "buttons": {
    "Home": "HOME",
    "Back": "BACK"
  }

• Keycode Reference
  See Android KeyEvent docs

📝 Notes

• Tested on HarmonyOS 3.0 (Android 10)
• If the error "Remote host closed the connection" occurs repeatedly when using sndcpy, please manually kill sndcpy on your phone and try again. Or fall back to VLC

    vlc -Idummy --demux rawaud --network-caching=0 --play-and-exit tcl://localhost:28200   #if you havn't changed the port number

See Sndcpy for details

📄 License

LGPL-3.0 | © Command_Prompt