scrcpy — управление Android через USB и Wi-Fi¶
scrcpy — бесплатная утилита с открытым исходным кодом, предназначенная для отображения экрана и управления Android-устройством с компьютера. Программа работает на Windows, macOS и Linux, использует протокол ADB (Android Debug Bridge) и не требует установки каких-либо компонентов на сам смартфон — достаточно включить отладку по USB. Проект размещён на GitHub под лицензией Apache 2.0, разработан французским инженером Роменом Вилем (Genymobile) и поддерживается сообществом.
¶Возможности
Основные функции scrcpy:
- трансляция экрана устройства в окно на компьютере с задержкой около 35–70 мс;
- управление сенсорным экраном мышью и клавиатурой;
- перетаскивание файлов в окно для копирования на устройство;
- запись экрана в файл формата MP4;
- работа по Wi-Fi без подключения кабелем;
- поддержка нескольких одновременно подключённых устройств;
- режимы с различным разрешением, битрейтом и частотой кадров.
¶Установка
¶Windows
Наиболее простой способ — скачать готовый архив с официальной страницей релизов на GitHub (проект genymobile/scrcpy), распаковать его и запустить файл scrcpy.exe. В архив уже включены необходимые библиотеки ADB и FFmpeg, поэтому дополнительная настройка не требуется. При первом запуске Windows может запросить разрешение на сетевой доступ — его следует предоставить.
Альтернатива — установка через менеджер пакетов Chocolatey командой choco install scrcpy или через Scoop.
¶Linux
В большинстве дистрибутивов scrcpy доступен в официальных репозиториях:
- Debian/Ubuntu:
sudo apt install scrcpy - Fedora:
sudo dnf install scrcpy - Arch Linux:
sudo pacman -S scrcpy
¶macOS
Через менеджер пакетов Homebrew: brew install scrcpy. Требуется предварительно установить Android SDK Platform Tools для получения утилиты adb.
¶Подготовка Android-устройства
- На телефоне включается «Отладка по USB»: раздел «О телефоне» → семь нажатий на номер сборки → раздел «Для разработчиков» → включить «Отладка по USB».
- При первом подключении к компьютеру на экране устройства появляется запрос на разрешение отладки — его необходимо подтвердить, установив отметку «Всегда разрешать с этого компьютера».
- Проверка соединения выполняется командой
adb devices— в списке должно отображаться серийный номер устройства в статусеdevice.
¶Запуск и базовое использование
Для запуска достаточно подключить телефон кабелем и выполнить команду scrcpy в терминале либо запустить исполняемый файл. Окно программы отобразит экран устройства в реальном времени.
Основные сочетания клавиш (работают при фокусе на окне scrcpy):
| Действие | Сочетание клавиш |
|---|---|
| Свернуть экран устройства | Ctrl+O |
| Включить/выключить экран | Ctrl+Shift+O |
| Показать панель уведомлений | Ctrl+Shift+N |
| Переключить ориентацию | Ctrl+R |
| Копировать в буфер обмена | Ctrl+C |
| Вставить из буфера обмена | Ctrl+V |
| Перезагрузка устройства в recovery | Ctrl+Shift+R |
| Завершение текущего приложения | Ctrl+Shift+Q |
| Выход из scrcpy | Ctrl+Q |
Управление мышью работает как касание пальцем: левая кнопка — тап, перетаскивание — свайп, прокрутка колеса — скроллинг. Правая кнопка мыши по умолчанию эмулирует кнопку «Назад».
¶Работа по Wi-Fi
Беспроводное подключение выполняется в два этапа.
- Подключение по USB и запуск команды
adb tcpip 5555— устройство начинает слушать ADB-соединения по указанному порту. - Отключение кабеля и запуск
adb connect <IP-адрес>:5555, после чегоscrcpyзапускается в обычном режиме.
IP-адрес устройства можно узнать в настройках Wi-Fi (раздел «Сведения о сети»). Для более удобного подключения используется скрипт scrcpy-wifi, который автоматизирует оба шага.
¶Полезные параметры командной строки
| Параметр | Назначение |
|---|---|
-m 1024 | ограничение длинной стороны экрана в пикселях |
-b 8M | установка битрейта видеопотока |
-r 60 | ограничение частоты кадров |
--record file.mp4 | запись экрана в файл |
--turn-screen-off | выключение физического экрана устройства при запуске |
--stay-awake | предотвращение засыпания устройства |
-s <serial> | выбор конкретного устройства при нескольких подключённых |
¶Применение
scrcpy активно используется для демонстрации интерфейса при разработке приложений, удалённой поддержки пользователей, тестирования на разных моделях устройств, а также для управления телефоном в ситуациях, когда сенсорный экран повреждён или недоступен. Программа не требует root-доступа и не модифицирует систему устройства.
¶Источники
- Официальный репозиторий scrcpy на GitHub (genymobile/scrcpy)
- Документация проекта: README и wiki на GitHub
- Man-страница scrcpy (дистрибутивы Linux)
