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

scrcpy (v5.0.1)

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

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

     

Основные акценты:

• лёгкость: нативное приложение, отображает только экран устройства
• производительность: 30~120 fps в зависимости от устройства
• качество: 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 fps, отключение звука и управление устройством путём эмуляции физической клавиатуры:

  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 в новом flex-дисплее с использованием 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  # короткая версия
  

Пользовательская документация

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