scrcpy

1 Instalação

scrcpy é uma ferramenta gratuita e de código aberto que espelha e controla seu dispositivo Android a partir de um computador. Instale usando o método que preferir:

Windows

WinGet (recomendado): winget install --exact Genymobile.scrcpy
Chocolatey: choco install scrcpy
Scoop: scoop install scrcpy
Manual: baixe a última versão e extraia o ZIP.

Linux

Arch Linux: pacman -S scrcpy
Fedora: dnf copr enable zeno/scrcpy && dnf install scrcpy
Debian/Ubuntu: compile a partir do código usando o script de instalação (a versão apt está desatualizada).
Snap: snap install scrcpy (pode estar desatualizado).

macOS

Homebrew (recomendado): brew install scrcpy
MacPorts: sudo port install scrcpy
Manual: baixe a última versão e extraia o tar.gz.

2 Espelhamento de Tela

Conecte seu dispositivo via USB e execute o scrcpy para espelhar a tela:

scrcpy

Para melhor qualidade e desempenho, experimente:

scrcpy --video-codec=h265 --max-size=1920 --max-fps=60 --no-audio

O encaminhamento de áudio requer Android 11+ (API 30). Para desabilitar o áudio:

scrcpy --no-audio

Você pode controlar o dispositivo com o teclado e mouse do computador. Clique direito aciona BACK, clique do meio aciona HOME e Alt+F alterna tela cheia.

3 Display Virtual (Desktop/Gaming)

O scrcpy pode criar um display virtual em vez de espelhar a tela física. Combinado com o Kwiq, isso ativa o Modo Desktop ou Modo Gaming dependendo da sua configuração. Esta é a forma recomendada de usar o Kwiq em telas grandes.

scrcpy --new-display=1920x1080

Desktop Mode:

scrcpy --new-display=1920x1080 --start-app=com.redclaw.kwiq/.desktop.DesktopActivity

Gaming Mode:

scrcpy --new-display=1920x1080 --start-app=com.redclaw.kwiq/.gaming.GamingActivity

Flex Display

Use --flex-display (ou -x) para redimensionar o display virtual para corresponder à janela do scrcpy:

scrcpy --new-display=1920x1080 --flex-display --keep-active

Sem Decorações do Sistema

Use --no-vd-system-decorations para desabilitar a UI do launcher padrão no display virtual, útil ao iniciar um app específico:

scrcpy --new-display=1920x1080 --no-vd-system-decorations --start-app=com.redclaw.kwiq/.desktop.DesktopActivity

Manter Apps ao Fechar

Por padrão, apps são destruídos quando o display virtual fecha. Use --no-vd-destroy-content para movê-los para a tela principal:

scrcpy --new-display --no-vd-destroy-content

4 Modo OTG

O modo OTG permite controlar o dispositivo usando um teclado, mouse ou gamepad físico conectado ao computador, como se estivessem plugados diretamente no Android via um cabo OTG. Não requer depuração USB!

scrcpy --otg

Para habilitar suporte a gamepad também:

scrcpy --otg --gamepad=aoa

Para desabilitar o teclado (apenas mouse):

scrcpy --otg --keyboard=disabled

Para desabilitar o mouse (apenas teclado):

scrcpy --otg --mouse=disabled

5 Conexão sem Fio

Você pode conectar sem fio via Wi-Fi. Primeiro, conecte via USB e ative o modo TCP/IP:

scrcpy --tcpip

Isso encontra automaticamente o IP do dispositivo e ativa o modo sem fio.

Configuração Manual

Se o dispositivo já escuta em TCP/IP (ex: após adb tcpip 5555):

scrcpy --tcpip=192.168.1.1

6 Dicas e Atalhos