[!WARNING] Este repositório do GitHub (https://github.com/Genymobile/scrcpy) é a única fonte oficial do projeto. Não baixe versões a partir de sites aleatórios, mesmo que o nome deles contenha scrcpy.

scrcpy (v5.0.1)

pronuncia-se "screen copy"

Esta aplicação espelha dispositivos Android (vídeo e áudio) conectados via USB ou TCP/IP e permite o controle usando o teclado e o mouse do computador. Não requer acesso root nem um app instalado no dispositivo. Funciona em Linux, Windows e macOS.

screenshot

Ele foca em:

leveza: nativo, exibe apenas a tela do dispositivo
desempenho: 30~120fps, dependendo do dispositivo
qualidade: 1920×1080 ou superior
baixa latência: 35~70ms
baixo tempo de inicialização: ~1 segundo para exibir a primeira imagem
não intrusivo: nada fica instalado no dispositivo Android
benefícios ao usuário: sem conta, sem anúncios, sem necessidade de internet
liberdade: software livre e de código aberto

Seus recursos incluem:

encaminhamento de áudio (Android 11+)
gravação
display virtual
espelhamento com tela do dispositivo Android desligada
copiar-colar em ambas as direções
qualidade configurável
espelhamento de câmera (Android 12+)
espelhamento como webcam (V4L2) (somente Linux)
simulação de teclado e mouse físicos (HID)
suporte a gamepad
modo OTG
e mais…

Pré-requisitos

O dispositivo Android requer pelo menos API 21 (Android 5.0).

O encaminhamento de áudio é suportado para API >= 30 (Android 11+).

Certifique-se de que você habilitou a depuração USB no(s) seu(s) dispositivo(s).

Em alguns dispositivos (especialmente Xiaomi), você pode receber o seguinte erro:

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

Nesse caso, você precisa habilitar uma opção adicional USB debugging (Security Settings) (este é um item diferente de USB debugging) para controlá-lo usando teclado e mouse. É necessário reiniciar o dispositivo uma vez que esta opção seja definida.

Observe que a depuração USB não é necessária para executar o scrcpy no modo OTG.

Obtenha o aplicativo

Dicas essenciais

Reduzir a resolução pode melhorar muito o desempenho (scrcpy -m1024)
Clique com o botão direito aciona BACK
Clique com o botão do meio aciona HOME
Alt+f alterna a tela cheia
Existem muitos outros atalhos

Exemplos de uso

Existem muitas opções, documentadas em páginas separadas. Aqui estão apenas alguns exemplos comuns.

Capturar a tela em H.265 (melhor qualidade), limitar o tamanho a 1920, limitar a taxa de quadros a 60fps, desativar o áudio e controlar o dispositivo simulando um teclado físico:
```
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  # short version
```
Iniciar o VLC em uma nova tela virtual (separada da tela do dispositivo):
```
scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
```
Iniciar o VLC em uma nova tela flex usando H.265 com uma taxa de bits de 16 Mbps, mantendo a tela ativa para que ela não desligue:
```
scrcpy --new-display -x --keep-active --start-app=org.videolan.vlc --video-codec=h265 -b16M
```

Gravar a câmera do dispositivo em H.265 a 1920x1080 (e o microfone) em um arquivo MP4:

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

Capturar a câmera frontal do dispositivo e expô-la como webcam no computador (no Linux):

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

Controlar o dispositivo sem espelhamento simulando um teclado e mouse físicos (depuração USB não necessária):
```
scrcpy --otg
```
Controlar o dispositivo usando gamepads conectados ao computador:
```
scrcpy --gamepad=uhid
scrcpy -G  # short version
```

Documentação do usuário

O aplicativo oferece muitos recursos e opções de configuração. Eles estão documentados nas seguintes páginas:

scrcpy