Этот GitHub репозиторий (https://github.com/Genymobile/scrcpy) является единственным официальным источником проекта. Не загружайте релизы со случайных веб-сайтов, даже если в их названии есть scrcpy.

scrcpy (v4.0)

произносится как "screen copy"

Это приложение зеркалирует Android-устройства (видео и аудио), подключённые через USB или TCP/IP, и позволяет управлять ими с помощью клавиатуры и мыши компьютера. Для работы не требуется root-доступ или установка приложения на устройство. Работает на Linux, Windows и macOS.

     

Основные особенности:

• лёгкость: нативный код, отображается только экран устройства
• производительность: 30~120 к/с в зависимости от устройства
• качество: 1920×1080 или выше
• низкая задержка: 35~70 мс
• быстрый запуск: ~1 секунда до появления первого изображения
• ненавязчивость: на Android-устройстве не остаётся никаких установленных файлов
• удобство для пользователя: не требуется аккаунт, реклама или интернет
• свобода: бесплатное программное обеспечение с открытым исходным кодом

Его возможности включают:

• передача аудио (Android 11+)
• запись
• виртуальный дисплей
• зеркалирование с выключенным экраном Android-устройства
• копирование-вставка в обе стороны
• настраиваемое качество
• зеркалирование камеры (Android 12+)
• зеркалирование как веб-камера (V4L2) (только Linux)
• симуляция физической клавиатуры и мыши (HID)
• поддержка геймпадов
• режим OTG
• и многое другое…

Предварительные требования

На Android-устройстве должен быть установлен API не ниже 21 (Android 5.0).

Передача аудио поддерживается для API >= 30 (Android 11+).

Убедитесь, что вы включили отладку по USB на устройстве(ах).

На некоторых устройствах (особенно Xiaomi) может появиться следующая ошибка:

Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.

В этом случае необходимо включить дополнительную опцию USB debugging (Security Settings) (она отличается от USB debugging) для управления с помощью клавиатуры и мыши. После включения этой опции требуется перезагрузить устройство.

Обратите внимание, что отладка по USB не требуется для работы scrcpy в режиме OTG.

Получить приложение

• Linux
• Windows (прочитайте как запустить)
• macOS

Важные советы

• Уменьшение разрешения может значительно повысить производительность (scrcpy -m1024)
• Правая кнопка мыши вызывает BACK
• Средняя кнопка мыши вызывает HOME
• Alt+f переключает полноэкранный режим
• Существует множество других горячих клавиш

Примеры использования

Существует множество опций, описанных на отдельных страницах. Вот лишь несколько распространённых примеров.

• Захват экрана в H.265 (лучшее качество), ограничение размера до 1920, ограничение частоты кадров до 60 к/с, отключение аудио и управление устройством с симуляцией физической клавиатуры:

  scrcpy --video-codec=h265 --max-size=1920 --max-fps=60 --no-audio --keyboard=uhid
  scrcpy --video-codec=h265 -m1920 --max-fps=60 --no-audio -K  # короткая версия
  

• Запуск VLC на новом виртуальном дисплее (отдельно от дисплея устройства):

  scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
  

• Запуск VLC на новом гибком дисплее с использованием H.265 и битрейтом 16 Мбит/с, при этом дисплей остаётся активным (не выключается):

  scrcpy --new-display -x --keep-active --start-app=org.videolan.vlc --video-codec=h265 -b16M
  

• Запись камеры устройства в H.265 с разрешением 1920x1080 (и микрофона) в MP4-файл:

  scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4
  

• Захват фронтальной камеры устройства и её использование как веб-камеры на компьютере (на Linux):

  scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback
  

• Управление устройством без зеркалирования с симуляцией физической клавиатуры и мыши (отладка по USB не требуется):

  scrcpy --otg
  

• Управление устройством с помощью подключённых к компьютеру геймпадов:

  scrcpy --gamepad=uhid
  scrcpy -G  # короткая версия
  

Документация пользователя

Приложение предоставляет множество функций и опций конфигурации. Они описаны на следующих страницах: