-
A desktop application for controlling multiple Android devices
Features | Screenshots | Installation | Build from Source | Tech Stack | Credits
insynic is a desktop application for controlling and operating Android devices. Built on top of the scrcpy engine, it integrates screen mirroring, file management, OTG input, virtual key mapping, and more, with bilingual support for English and Chinese.
- USB Connection: Connect Android devices via USB cable with automatic device detection
- Network Connection: Connect to remote Android devices via TCP/IP (WiFi) with customizable port (default 5555)
- Auto Device Detection: Automatically scans and lists all available devices on startup
- Real-time screen mirroring powered by the scrcpy engine
- Customizable resolution, frame rate, and bit rate
- Screen-off control (turn off display while still operating the device)
- Screen window auto-resizes to match video frame resolution
- Navigation Keys: Back, Home, Task, Menu
- Volume Control: Volume up, Volume down
- System Panels: Expand/collapse notification and settings panels
- Screen Rotation: Rotate device screen orientation with one click
- Power Control: Toggle screen on/off without locking the device
- Maps Mac keyboard as an Android input device via USB OTG mode
- Runs as a separate process without interfering with screen mirroring
- Supports Cmd+Q shortcut to exit OTG mode
- ADB-based file browser
- Browse and manage files on device internal storage
- Add Virtual Keys: Place draggable virtual key buttons on the screen window
- Key Configuration: Double-click a virtual key to listen for keyboard input mapping; configurable key size (20-100 pixels)
- Multi-key Support: Add multiple virtual keys simultaneously
- Touch Simulation: Sends touch events to the device via the scrcpy control protocol
- Save Profiles: Save current window position, size, and all virtual key configurations
- Custom Naming: Support for custom profile names with overwrite confirmation
- Apply Profiles: Load saved configurations with one click
- Delete Profiles: Remove unwanted configuration files
- System Tray: Menu bar icon with show/hide window support
- Streaming Settings: Configurable resolution, frame rate, and bit rate
- Internationalization: English/Chinese language switching with automatic preference saving
- Dark Theme: Native macOS dark interface
Screenshots will be added later
- macOS 12.0 or later
- Android device with USB debugging enabled
- Enable Developer Options and USB Debugging on your Android device
- Authorize USB debugging on the device when connecting via USB for the first time
- Download the latest
insynic.appfrom the Releases page - Drag the app into the
Applicationsfolder - On first launch, if prompted by security settings, go to
System Settings → Privacy & Security → Allow Anyway
- Connect your Android device to your Mac via USB (or use network connection)
- Select your device from the dropdown list (or choose "Network Connection" to enter IP and port)
- Click "Connect" to connect to the device
- The screen window will pop up automatically upon successful connection
- Use the buttons on the control panel to operate the device
- CMake >= 3.20
- Qt 6.x (install via Homebrew:
brew install qtbase) - SDL3 (install via Homebrew:
brew install sdl3) - FFmpeg (install via Homebrew:
brew install ffmpeg) - libusb (install via Homebrew:
brew install libusb) - scrcpy source: The scrcpy app source directory is required for compilation
# 1. Clone the repository
git clone https://github.com/your-username/insynic.git
cd insynic
# 2. Ensure scrcpy source is in the parent directory
# Expected directory structure:
# insynic/ <- This project
# scrcpy/ <- scrcpy source
# 3. Create build directory and compile
cd insynic
mkdir build && cd build
cmake ..
make -j$(sysctl -n hw.ncpu)After building, the app is located at build/insynic.app.
The build process automatically:
- Compiles the scrcpy static library
- Bundles
adbandscrcpy-serverinto the app's Resources directory - Deploys Qt frameworks using
macdeployqt - Copies translation files into the app bundle
insynic/
├── insynic/
│ ├── CMakeLists.txt # Main build configuration
│ ├── Info.plist.in # macOS app info template
│ ├── src/
│ │ ├── main.cpp # Application entry point
│ │ ├── scrcpy_lib/ # scrcpy wrapper layer (C)
│ │ ├── ui/ # User interface layer
│ │ │ ├── insynic_mainwindow.* # Main window
│ │ │ ├── insynic_settingsdialog.* # Streaming settings dialog
│ │ │ ├── insynic_networkdialog.* # Network connection dialog
│ │ │ ├── insynic_filebrowser.* # File browser
│ │ │ ├── insynic_customtranslator.*# Custom translator
│ │ │ ├── macos_menu.mm # macOS native menu
│ │ │ └── qt_nsview.mm # NSView embedding
│ │ ├── controlpanel/ # Control panel module
│ │ │ ├── insynic_controlpanel.* # Control panel
│ │ │ ├── insynic_draggablekey.* # Draggable virtual key
│ │ │ ├── insynic_keyconfigdialog.*# Key config dialog
│ │ │ ├── insynic_saveprofiledialog.*# Save profile dialog
│ │ │ └── insynic_profilemanager.* # Profile manager
│ │ └── filemanager/ # ADB file management module
│ └── translations/
│ └── insynic_zh.ts # Chinese translation file
└── README.md
| Technology | Purpose |
|---|---|
| Qt 6 | Application framework, UI |
| scrcpy | Android screen mirroring & control engine |
| SDL3 | Video rendering window |
| FFmpeg | Video decoding (H.264) |
| ADB | Android Debug Bridge, device communication |
| libusb | USB communication (OTG mode) |
| CMake | Build system |
This project is built upon the following open-source projects. Thanks to their developers:
- scrcpy — Android screen mirroring and control tool, by Romain Vimont
- Android Debug Bridge (ADB) — Google's official Android debugging tool
- Qt — Cross-platform C++ application development framework
- SDL — Simple DirectMedia Layer
- FFmpeg — Multimedia processing library
厨房 / OMADAFAKA