GitHub Genymobile scrcpy: полное руководство по установке и настройке

Ошибка «adb: device not found» при первом запуске scrcpy с репозитория github.com/genymobile/scrcpy почти всегда означает одно: на смартфоне не включена отладка по USB, либо Windows не видит устройство из-за отсутствующего драйвера. Проверка занимает пару минут: подключите телефон кабелем, выполните команду adb devices в терминале и посмотрите, появился ли серийный номер устройства в списке. Если строка есть, но помечена как unauthorized — на экране смартфона нужно подтвердить разрешение на отладку.

scrcpy — это бесплатная утилита с открытым исходным кодом от компании Genymobile, которая выводит экран Android-устройства на компьютер и позволяет управлять им мышью и клавиатурой. Программа не требует root-прав, не ставит приложение-клиент на телефон в привычном смысле и работает через протокол ADB. В этой статье разберём, как скачать scrcpy с официального репозитория, установить на разные системы, подключиться по кабелю и по Wi-Fi, а также решить типичные проблемы.

Что такое scrcpy и как он работает

Принцип работы утилиты прост: серверная часть временно загружается на устройство через ADB, захватывает видеопоток экрана и передаёт его на компьютер, а ввод с мыши и клавиатуры отправляется обратно. После завершения сеанса сервер удаляется автоматически — на телефоне не остаётся лишних приложений.

Для работы необходимо устройство на Android 5.0 (API 21) или новее и включённая отладка по USB в настройках разработчика. Передача звука с устройства поддерживается в свежих версиях scrcpy, но требует более новой версии Android — если звук не работает, проверьте версию системы на смартфоне и обновите саму утилиту.

  • 🖥️ Трансляция экрана с низкой задержкой по USB и Wi-Fi
  • ⌨️ Управление мышью и клавиатурой, копирование текста между устройствами
  • 🎥 Запись экрана в файл без сторонних программ
  • 🔓 Отсутствие необходимости в root-правах

Как скачать scrcpy с github.com/genymobile/scrcpy

Официальный источник — страница релизов репозитория genymobile/scrcpy на GitHub, раздел Releases. Для Windows автор публикует готовый архив со всеми необходимыми файлами, включая adb.exe — отдельно устанавливать Android SDK не нужно.

Вам нужно скачать архив вида scrcpy-win64-... (для 64-битной системы), распаковать его в любую папку и запустить scrcpy.exe или scrcpy-console.bat — второй вариант открывает окно терминала, где видны сообщения об ошибках, что удобно при первой настройке.

⚠️ Внимание: скачивайте scrcpy только с официального репозитория Genymobile на GitHub или из штатных пакетных менеджеров вашей системы. Сторонние сайты с «сборками» могут содержать модифицированные файлы.

Установка на Windows, Linux и macOS

На Windows установка сводится к распаковке архива, описанной выше. На Linux и macOS удобнее использовать пакетные менеджеры — так проще получать обновления.

Для дистрибутивов на базе Debian и Ubuntu утилита доступна в репозиториях, для macOS — через Homebrew:

sudo apt install scrcpy

brew install scrcpy

Учтите, что версия в системных репозиториях Linux может отставать от актуальной на GitHub. Если нужна свежая версия с последними функциями — соберите из исходников по инструкции из файла doc в репозитории или используйте релизный архив.

📊 На какой системе вы запускаете scrcpy?
Windows
Linux
macOS
Пока только выбираю

Включение отладки по USB на Android

Без этого шага подключение невозможно. Точные названия пунктов меню зависят от оболочки производителя (MIUI, One UI, ColorOS и т.д.), поэтому при расхождениях сверяйтесь с документацией своей модели.

☑️ Подготовка смартфона к подключению

Выполнено: 0 / 5

После включения отладки подключите устройство кабелем и выполните проверку:

adb devices

Если устройство отображается со статусом device — всё готово. Статус unauthorized означает, что на экране телефона ждёт подтверждения диалог разрешения отладки. Пустой список — признак проблемы с кабелем, портом или драйвером.

⚠️ Внимание: используйте кабель, поддерживающий передачу данных. Некоторые кабели от зарядных устройств передают только питание — с ними компьютер вообще не увидит смартфон.

Подключение по USB и по Wi-Fi

По кабелю достаточно запустить scrcpy без параметров — окно с экраном телефона откроется автоматически. Беспроводное подключение работает через TCP/IP и требует, чтобы компьютер и смартфон находились в одной сети.

Порядок действий для подключения по Wi-Fi: сначала подключите устройство кабелем, переведите ADB в сетевой режим, узнайте IP-адрес телефона и подключитесь к нему:

adb tcpip 5555

adb connect 192.168.1.50:5555

scrcpy

IP-адрес подставьте свой — его можно посмотреть в настройках Wi-Fi на телефоне. После этого кабель можно отключить. Учтите, что после перезагрузки смартфона сетевой режим ADB обычно сбрасывается, и процедуру придётся повторить.

В свежих версиях Android также доступна беспроводная отладка через раздел «Для разработчиков» с сопряжением по коду — если функция предусмотрена вашей версией системы, это альтернатива начальному подключению кабелем.

Полезные команды и параметры scrcpy

Базовый запуск подходит большинству, но параметры командной строки заметно расширяют возможности. Вот проверенные опции из официальной документации:

КомандаНазначение
scrcpy -m 1024Ограничить разрешение трансляции для снижения нагрузки
scrcpy --turn-screen-offПогасить экран телефона во время сеанса
scrcpy --record file.mp4Записать трансляцию в видеофайл
scrcpy --no-audioОтключить передачу звука
scrcpy --stay-awakeНе давать устройству уснуть при подключении

Полный список опций выводится командой scrcpy --help, а подробное описание есть в документации репозитория. Параметры можно комбинировать: например, запись с ограничением разрешения задаётся одной строкой.

Почему снижение разрешения ускоряет трансляцию

Параметр -m уменьшает количество кодируемых пикселей, что снижает нагрузку на процессор смартфона, канал передачи и декодер на компьютере. Это особенно заметно при подключении по Wi-Fi или на слабом ПК: картинка становится чуть менее чёткой, но задержка и подёргивания уменьшаются.

Типичные ошибки и их решение

Разберём проблемы, с которыми чаще всего сталкиваются при работе с scrcpy.

  • 🔌 Устройство не определяется — проверьте кабель с поддержкой данных, смените USB-порт, на Windows установите драйвер от производителя смартфона
  • 🚫 unauthorized в adb devices — отзовите разрешения в разделе разработчика («Отозвать доступ для отладки по USB») и подтвердите диалог заново
  • 📺 Чёрный экран в окне scrcpy — попробуйте снизить разрешение через -m 1024; на некоторых устройствах защищённый контент (банковские приложения, DRM-видео) не транслируется в принципе
  • 🔊 Нет звука — проверьте версию scrcpy и Android; передача аудио требует достаточно свежей версии системы
⚠️ Внимание: чёрный экран в отдельных приложениях — это не неисправность, а системная защита Android от захвата защищённого контента. Обойти её штатными средствами scrcpy нельзя, и пытаться делать это сторонними методами не стоит.

Если ничего не помогает, запустите scrcpy-console.bat (на Windows) или scrcpy из терминала и прочитайте текст ошибки — в большинстве случаев там прямо указано, на каком этапе произошёл сбой: поиск устройства, запуск сервера или кодирование видео.

Часто задаваемые вопросы

Нужен ли root для работы scrcpy?

Нет. Утилита работает через стандартный интерфейс ADB и не требует root-прав, разблокировки загрузчика или установки приложений на смартфон. Достаточно включённой отладки по USB.

Безопасно ли скачивать scrcpy с GitHub?

Репозиторий genymobile/scrcpy — официальный источник проекта с открытым исходным кодом. Скачивайте файлы только из раздела Releases этого репозитория или используйте пакетные менеджеры вашей системы. Сборки с посторонних сайтов могут быть изменены.

Почему телефон не виден в adb devices?

Возможные причины: кабель без поддержки передачи данных, не включена отладка по USB, на Windows отсутствует драйвер устройства, либо на телефоне не подтверждён диалог разрешения. Проверяйте пункты по очереди, начиная с кабеля.

Можно ли использовать scrcpy без кабеля вообще?

Да, по Wi-Fi, но первичный перевод ADB в сетевой режим обычно требует однократного подключения кабелем. На свежих версиях Android доступна беспроводная отладка с сопряжением по коду — если она есть в вашей системе, кабель не понадобится вовсе.

Записывает ли scrcpy видео со звуком?

Запись в файл поддерживается параметром --record. Захват аудио зависит от версии scrcpy и версии Android на устройстве — сверьтесь с документацией к вашей версии в репозитории.