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

scrcpy (v4.0)

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

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

screenshot

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

лёгкость: нативный код, отображается только экран устройства
производительность: 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  # короткая версия
```

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

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

Ресурсы

Статьи

Контакты

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

Для сообщений об ошибках сначала прочитайте FAQ — возможно, вы сразу найдёте решение своей проблемы.

Также можно использовать:

Reddit: r/scrcpy
BlueSky: @scrcpy.bsky.social
Twitter: @scrcpy_app

Пожертвования

Я — @rom1v, автор и мейнтейнер scrcpy.

Если вам нравится это приложение, вы можете поддержать мою работу с открытым исходным кодом:

Лицензия

Copyright (C) 2018 Genymobile
Copyright (C) 2018-2026 Romain Vimont

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

scrcpy v4.1

Категории