scrcpy

Espeja la pantalla, crea pantallas virtuales, usa el modo OTG y controla el Modo Escritorio desde tu PC con scrcpy.

1 Instalación

scrcpy es una herramienta gratuita y de código abierto que espeja y controla tu dispositivo Android desde una computadora. Instálala usando tu método preferido:

Windows

WinGet (recomendado): winget install --exact Genymobile.scrcpy
Chocolatey: choco install scrcpy
Scoop: scoop install scrcpy
Manual: descarga la última versión y extrae el ZIP.

Linux

Arch Linux: pacman -S scrcpy
Fedora: dnf copr enable zeno/scrcpy && dnf install scrcpy
Debian/Ubuntu: compila desde el código usando el script de instalación (la versión apt está obsoleta).
Snap: snap install scrcpy (puede estar obsoleto).

macOS

Homebrew (recomendado): brew install scrcpy
MacPorts: sudo port install scrcpy
Manual: descarga la última versión y extrae el tar.gz.
Nota

Tu dispositivo Android necesita tener la depuración USB habilitada (Ajustes > Opciones de Desarrollador). En dispositivos Xiaomi, habilita también depuración USB (Ajustes de Seguridad) y reinicia. Para el modo OTG, la depuración USB NO es necesaria.

2 Espejado de Pantalla

Conecta tu dispositivo por USB y ejecuta scrcpy para espejar la pantalla:

scrcpy

Para mejor calidad y rendimiento, prueba:

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

El reenvío de audio requiere Android 11+ (API 30). Para deshabilitar el audio:

scrcpy --no-audio

Puedes controlar el dispositivo con el teclado y ratón del ordenador. Clic derecho activa BACK, clic central activa HOME y Alt+F alterna pantalla completa.

3 Pantalla Virtual (Escritorio/Gaming)

scrcpy puede crear una pantalla virtual en lugar de espejar la pantalla física. Combinado con Kwiq, esto activa el Modo Escritorio o Modo Gaming dependiendo de tu configuración. Esta es la forma recomendada de usar Kwiq en pantallas 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

Usa --flex-display (o -x) para redimensionar la pantalla virtual al tamaño de la ventana de scrcpy:

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

Usa --keep-active para evitar que la pantalla del dispositivo se apague mientras la pantalla virtual esté activa.

Sin Decoraciones del Sistema

Usa --no-vd-system-decorations para deshabilitar la UI del launcher predeterminado en la pantalla virtual, útil al iniciar una app específica:

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

Mantener Apps al Cerrar

Por defecto, las apps se destruyen cuando la pantalla virtual se cierra. Usa --no-vd-destroy-content para moverlas a la pantalla principal:

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

4 Modo OTG

El modo OTG te permite controlar el dispositivo usando un teclado, ratón o gamepad físico conectado a tu ordenador, como si estuvieran enchufados directamente al Android vía un cable OTG. ¡No requiere depuración USB!

scrcpy --otg

Para habilitar soporte de gamepad también:

scrcpy --otg --gamepad=aoa

Para deshabilitar el teclado (solo ratón):

scrcpy --otg --keyboard=disabled

Para deshabilitar el ratón (solo teclado):

scrcpy --otg --mouse=disabled
Nota

El modo OTG solo funciona por USB. Para control inalámbrico con HID, usa scrcpy --no-video --no-audio -KMG (requiere depuración USB).

5 Conexión Inalámbrica

Puedes conectar inalámbricamente por Wi-Fi. Primero, conecta por USB y activa el modo TCP/IP:

scrcpy --tcpip

Esto encuentra automáticamente la IP del dispositivo y activa el modo inalámbrico.

Configuración Manual

Si el dispositivo ya escucha en TCP/IP (ej: después de adb tcpip 5555):

scrcpy --tcpip=192.168.1.1
Consejo

Las conexiones inalámbricas cambian latencia por comodidad sin cables. Para juegos o Modo Escritorio, se recomienda USB.

6 Consejos y Atajos

Resoluciones comunes

Usa --new-display=WxH con estos tamaños:
Full HD: 1920x1080
HD: 1280x720
4K: 3840x2160
Ultrawide: 2560x1080

Codec H.265

Usa --video-codec=h265 para mejor calidad con bitrates más bajos. Añade -b16M para bitrate alto.

Grabación

Graba la pantalla con --record=file.mp4. Combina con --no-playback para grabación headless.

Atajos de teclado

MOD+F: pantalla completa | MOD+G: redimensionar | MOD+r: rotar | MOD+Shift+r: rotar inverso | MOD+s: salvapantallas | Ver todos los atajos.