scrcpy README

The project's README from github.com/Genymobile/scrcpy. As one markdown file: README.md.

[!WARNING] This GitHub repo (https://github.com/Genymobile/scrcpy) is the only official source for the project. Do not download releases from random websites, even if their name contains scrcpy.

scrcpy (v4.1)

scrcpy

pronounced "screen copy"

This application mirrors Android devices (video and audio) connected via USB or TCP/IP and allows control using the computer's keyboard and mouse. It does not require root access or an app installed on the device. It works on Linux, Windows, and macOS.

Linux  Windows  macOS 

screenshot

It focuses on:

Its features include:

Prerequisites

The Android device requires at least API 21 (Android 5.0).

Audio forwarding is supported for API >= 30 (Android 11+).

Make sure you enabled USB debugging on your device(s).

On some devices (especially Xiaomi), you might get the following error:

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

In that case, you need to enable an additional option USB debugging (Security Settings) (this is an item different from USB debugging) to control it using a keyboard and mouse. Rebooting the device is necessary once this option is set.

Note that USB debugging is not required to run scrcpy in OTG mode.

Get the app

Must-know tips

Usage examples

There are a lot of options, documented in separate pages. Here are just some common examples.

User documentation

The application provides a lot of features and configuration options. They are documented in the following pages:

Resources

Articles

Contact

You can open an issue for bug reports, feature requests or general questions.

For bug reports, please read the FAQ first, you might find a solution to your problem immediately.

You can also use:

Donate

I'm @rom1v, the author and maintainer of scrcpy.

If you appreciate this application, you can support my open source work:

License

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 (Genymobile/scrcpy)

Searching Database…

152.4K ·GitHub
Scrcpy
Что это такое?scrcpy (произносится «скрин копи») показывает экран вашего Android-устройства на компьютере и позволяет им управлять: он передаёт видео и звук по USB или TCP/IP, и вы можете управлять телефоном с клавиатуры и мыши.
Нужно ли что-то устанавливать на телефон?Ничего — это приложение для компьютера под Linux, Windows и macOS. Оно не требует root-доступа и не оставляет на Android-устройстве ничего установленного.
Что нужно, чтобы начать транслировать экран телефона?Установите приложение для своей ОС, включите отладку по USB в настройках разработчика на телефоне, затем подключите кабель или соединитесь по TCP/IP.
Моя версия Android будет поддерживаться?Подойдёт любое устройство с Android 5.0 (API 21) или новее; передача звука требует Android 11+, а трансляция камеры — Android 12+.
Есть ли устройства, где управление сразу не заработает?Да — на некоторых телефонах, например на Xiaomi, нужно дополнительно включить «Отладку по USB (настройки безопасности)» и перезагрузить устройство, прежде чем заработает управление с клавиатуры и мыши.
Трансляция отправляет что-то в интернет?Нет. scrcpy работает без аккаунта, без рекламы и без интернета — экран и звук передаются по вашему собственному соединению USB или TCP/IP.
Насколько плавная трансляция на практике?Рассчитывайте на 30~120 к/с в зависимости от устройства, разрешение 1920×1080 и выше, задержку 35~70 мс и примерно одну секунду до появления первого изображения.
Что он умеет помимо простой трансляции экрана?Он записывает экран, транслирует его при выключенном экране Android, копирует и вставляет в обе стороны, запускает приложения на виртуальных экранах, эмулирует физические клавиатуру и мышь по HID, поддерживает геймпады и имеет OTG-режим.
Может ли он использовать камеру телефона или работать как веб-камера?Да — на Android 12+ он может транслировать камеру и записывать её в MP4, а на Linux может выдавать фронтальную камеру устройства как веб-камеру через V4L2.
Какие горячие клавиши обязательно нужно знать во время работы?Правый клик выполняет BACK, средний клик — HOME, Alt+f переключает полноэкранный режим, а запуск scrcpy -m1024 для снижения разрешения может заметно повысить производительность.
What are similar projects?escrcpy, QtScrcpy, Recordly, Captura, WebRTC-Experiment, my-tv, screenity, rustdesk
Which topics is it in?sdl2, screencast, recording, adb, mouse, screen-recording, webcam, screen-capture, usb, remote-desktop, remote-control, keyboard
Creator
Genymobile
Size
9.1 MB
Stars
152.4K
Updated
CommitOct 08Releasev5.0.1Oct 08
Age
8y
Commits · 90 Days