scrcpy

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

# scrcpy (v5.0.1)

<img src="https://raw.githubusercontent.com/genymobile/scrcpy/HEAD/app/data/scrcpy.svg" width="128" height="128" alt="scrcpy" align="right" />

_произносится как "**scr**een **c**o**py**"_

Это приложение отображает экран Android-устройств (видео и аудио), подключённых через USB или
[TCP/IP](https://github.com/genymobile/scrcpy/blob/master/doc/connection.md#tcpip-wireless), и позволяет управлять ими с помощью
клавиатуры и мыши компьютера. Оно не требует доступа _root_ или установки приложения
на устройстве. Работает на _Linux_, _Windows_ и _macOS_.

[![Linux](https://img.shields.io/badge/Linux-download-orange?style=for-the-badge&logo=linux)](doc/linux.md)&nbsp;
[![Windows](https://img.shields.io/badge/Windows-download-blue?style=for-the-badge&logo=windows)](doc/windows.md)&nbsp;
[![macOS](https://img.shields.io/badge/macOS-download-brightgreen?style=for-the-badge&logo=apple)](doc/macos.md)&nbsp;

![screenshot](https://assets.kitploit.com/production/public/readmes/5644/100f9c3d2a94e604729a6e0e13223f4238b3efce1deb88e82bedd16c4c6b337b.jpg)

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

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

[lowlatency]: https://github.com/Genymobile/scrcpy/pull/646

Возможности включают:
 - [передачу аудио](https://github.com/genymobile/scrcpy/blob/master/doc/audio.md) (Android 11+)
 - [запись](https://github.com/genymobile/scrcpy/blob/master/doc/recording.md)
 - [виртуальный дисплей](https://github.com/genymobile/scrcpy/blob/master/doc/virtual-display.md)
 - зеркалирование при [выключенном экране Android-устройства](https://github.com/genymobile/scrcpy/blob/master/doc/device.md#turn-screen-off)
 - [копирование и вставку](https://github.com/genymobile/scrcpy/blob/master/doc/control.md#copy-paste) в обоих направлениях
 - [настраиваемое качество](https://github.com/genymobile/scrcpy/blob/master/doc/video.md)
 - [зеркалирование камеры](https://github.com/genymobile/scrcpy/blob/master/doc/camera.md) (Android 12+)
 - [зеркалирование в качестве веб-камеры (V4L2)](https://github.com/genymobile/scrcpy/blob/master/doc/v4l2.md) (только Linux)
 - эмуляцию физической [клавиатуры][hid-keyboard] и [мыши][hid-mouse] (HID)
 - поддержку [геймпада](https://github.com/genymobile/scrcpy/blob/master/doc/gamepad.md)
 - [режим OTG](https://github.com/genymobile/scrcpy/blob/master/doc/otg.md)
 - и многое другое…

[hid-keyboard]: https://raw.githubusercontent.com/genymobile/scrcpy/master/doc/keyboard.md#physical-keyboard-simulation
[hid-mouse]: https://raw.githubusercontent.com/genymobile/scrcpy/master/doc/mouse.md#physical-mouse-simulation

## Требования

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

[Передача аудио](https://github.com/genymobile/scrcpy/blob/master/doc/audio.md) поддерживается для API >= 30 (Android 11+).

Убедитесь, что вы [включили отладку по USB][enable-adb] на своём устройстве (устройствах).

[enable-adb]: https://developer.android.com/studio/debug/dev-options#enable

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

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

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

[control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323

Обратите внимание, что USB-отладка не требуется для запуска scrcpy в [режиме OTG](https://github.com/genymobile/scrcpy/blob/master/doc/otg.md).


## Получение приложения

 - [Linux](https://github.com/genymobile/scrcpy/blob/master/doc/linux.md)
 - [Windows](https://github.com/genymobile/scrcpy/blob/master/doc/windows.md) (читайте [как запустить](https://github.com/genymobile/scrcpy/blob/master/doc/windows.md#run))
 - [macOS](https://github.com/genymobile/scrcpy/blob/master/doc/macos.md)


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

 - [Снижение разрешения](https://github.com/genymobile/scrcpy/blob/master/doc/video.md#size) может значительно повысить
   производительность (`scrcpy -m1024`)
 - [_Правый клик_](https://github.com/genymobile/scrcpy/blob/master/doc/mouse.md#mouse-bindings) вызывает `BACK`
 - [_Средний клик_](https://github.com/genymobile/scrcpy/blob/master/doc/mouse.md#mouse-bindings) вызывает `HOME`
 - <kbd>Alt</kbd>+<kbd>f</kbd> переключает [полноэкранный режим](https://github.com/genymobile/scrcpy/blob/master/doc/window.md#fullscreen)
 - Существует множество других [горячих клавиш](https://github.com/genymobile/scrcpy/blob/master/doc/shortcuts.md)


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

Есть множество опций, [описанных](#user-documentation) на отдельных страницах.
Вот лишь несколько распространённых примеров.

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

    ```bash
    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 в новом виртуальном дисплее (отдельно от дисплея устройства):

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

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

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

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

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

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

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

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

    ```bash
    scrcpy --otg
    ```

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

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

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

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

 - [Подключение](https://github.com/genymobile/scrcpy/blob/master/doc/connection.md)
 - [Видео](https://github.com/genymobile/scrcpy/blob/master/doc/video.md)
 - [Аудио](https://github.com/genymobile/scrcpy/blob/master/doc/audio.md)
 - [Управление](https://github.com/genymobile/scrcpy/blob/master/doc/control.md)
 - [Клавиатура](https://github.com/genymobile/scrcpy/blob/master/doc/keyboard.md)
 - [Мышь](https://github.com/genymobile/scrcpy/blob/master/doc/mouse.md)
 - [Геймпад](https://github.com/genymobile/scrcpy/blob/master/doc/gamepad.md)
 - [Устройство](https://github.com/genymobile/scrcpy/blob/master/doc/device.md)
 - [Окно](https://github.com/genymobile/scrcpy/blob/master/doc/window.md)
 - [Запись](https://github.com/genymobile/scrcpy/blob/master/doc/recording.md)
 - [Виртуальный дисплей](https://github.com/genymobile/scrcpy/blob/master/doc/virtual-display.md)
 - [Туннели](https://github.com/genymobile/scrcpy/blob/master/doc/tunnels.md)
 - [OTG](https://github.com/genymobile/scrcpy/blob/master/doc/otg.md)
 - [Камера](https://github.com/genymobile/scrcpy/blob/master/doc/camera.md)
 - [Video4Linux](https://github.com/genymobile/scrcpy/blob/master/doc/v4l2.md)
 - [Горячие клавиши](https://github.com/genymobile/scrcpy/blob/master/doc/shortcuts.md)


## Ресурсы

 - [FAQ](https://github.com/genymobile/scrcpy/blob/master/FAQ.md)
 - [Переводы][wiki] (не обязательно актуальные)
 - [Инструкции по сборке](https://github.com/genymobile/scrcpy/blob/master/doc/build.md)
 - [Разработчикам](https://github.com/genymobile/scrcpy/blob/master/doc/develop.md)
 - [Проверка подписей релизов](https://github.com/genymobile/scrcpy/blob/master/doc/verify-release.md)

[wiki]: https://github.com/Genymobile/scrcpy/wiki


## Статьи

- [Представляем scrcpy][article-intro]
- [Scrcpy теперь работает по беспроводной сети][article-tcpip]
- [Scrcpy 2.0, со звуком][article-scrcpy2]

[article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/
[article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/
[article-scrcpy2]: https://blog.rom1v.com/2023/03/scrcpy-2-0-with-audio/

## Контакты

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

Для сообщений об ошибках, пожалуйста, сначала прочитайте [FAQ](https://github.com/genymobile/scrcpy/blob/master/FAQ.md), возможно, вы сразу найдёте решение
своей проблемы.

[issue]: https://github.com/Genymobile/scrcpy/issues

Вы также можете использовать:

 - Reddit: [`r/scrcpy`](https://www.reddit.com/r/scrcpy)
 - BlueSky: [`@scrcpy.bsky.social`](https://bsky.app/profile/scrcpy.bsky.social)
 - Twitter: [`@scrcpy_app`](https://twitter.com/scrcpy_app)


## Поддержать

Я [@rom1v](https://github.com/rom1v), автор и сопровождающий _scrcpy_.

Если вам нравится это приложение, вы можете [поддержать мою работу над открытым исходным кодом][donate]:
 - [GitHub Sponsors](https://github.com/sponsors/rom1v)
 - [Liberapay](https://liberapay.com/rom1v/)
 - [PayPal](https://paypal.me/rom2v)

[donate]: https://blog.rom1v.com/about/#support-my-open-source-work

## Лицензия

    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.