Important
Aviso Legal / Disclaimer: ScrcpyGUI es una interfaz gráfica (GUI) independiente y no oficial diseñada para facilitar el uso de scrcpy. Este proyecto es un complemento y no está afiliado, asociado ni respaldado por Genymobile ni por los desarrolladores originales de scrcpy. Todas las marcas comerciales y el motor de streaming pertenecen a sus respectivos dueños.
Una interfaz gráfica profesional, rápida y optimizada para la gestión de dispositivos Android mediante scrcpy. Diseñada con una arquitectura modular inspirada en los editores de código modernos (VS Code / JetBrains / Cursor), con escaneo automático de capacidades de hardware por dispositivo y soporte avanzado para pantallas virtuales.
Antes de usar ScrcpyGUI, asegúrate de cumplir con los siguientes requisitos en tu PC y en tu teléfono Android.
| Requisito | Detalle |
|---|---|
| Sistema Operativo | Windows 10/11 (64-bit), Linux o macOS |
| Python | Python 3.10 o superior (python.org) |
| pip | Viene incluido con Python. Se usa para instalar dependencias |
| scrcpy | Se descarga automáticamente desde la app, o puedes instalarlo manualmente desde github.com/Genymobile/scrcpy |
| ADB (Android Debug Bridge) | Incluido automáticamente con scrcpy en Windows. En Linux/macOS, instálalo con tu gestor de paquetes (sudo apt install adb / brew install android-platform-tools) |
| Cable USB | Necesario para la conexión inicial. Posteriormente puedes conectar por Wi-Fi |
Tip
¿No tienes scrcpy? ScrcpyGUI detecta si scrcpy no está instalado y te ofrece un botón de descarga automática directamente desde GitHub Releases. Solo necesitas conexión a internet.
| Requisito | Detalle |
|---|---|
| Versión de Android | Android 5.0 (Lollipop) como mínimo |
| Depuración USB | Obligatorio. Debe estar activada en Opciones de Desarrollador |
| Cable USB | Para la conexión inicial entre el teléfono y el PC |
- Ve a Ajustes -> Acerca del teléfono.
- Toca "Número de compilación" 7 veces seguidas hasta que se active el modo desarrollador.
- Vuelve a Ajustes -> Opciones de desarrollador (o Ajustes -> Sistema -> Opciones de desarrollador).
- Activa la opción "Depuración USB".
- Conecta el cable USB al PC y presiona "Permitir depuración USB" en la pantalla del teléfono.
Note
La ubicación del menú puede variar ligeramente según la marca del teléfono (Samsung, Xiaomi, Motorola, etc.), pero el procedimiento es el mismo.
La compatibilidad varía según la versión de Android instalada en el dispositivo:
| Función | Versión mínima de Android | Notas |
|---|---|---|
| Espejado de pantalla básico | Android 5.0+ | Compatible con la gran mayoría de dispositivos |
| Transmisión de Audio al PC | Android 11+ (API 30) | Permite escuchar el audio del móvil en el PC |
| Conexión Wi-Fi sin cable USB | Android 11+ (API 30) | Requiere emparejamiento con código de 6 dígitos |
| Pantallas Virtuales (Modo Escritorio / DeX) | Android 10+ (API 29) | Crea una segunda pantalla independiente |
| Pantalla Flex (redimensionable) | Android 10+ y scrcpy v4.0+ | La pantalla virtual adapta su tamaño al de la ventana en PC |
| Control por Hardware UHID (Teclado / Ratón) | Android 13+ (API 33) | Teclado y ratón funcionan como periféricos nativos |
| Modo OTG (Hardware puro) | Android 5.0+ | Control directo vía emulación de hardware USB |
| Cámara como Webcam | Android 12+ (API 31) y scrcpy v2.7+ | Usa la cámara del teléfono como webcam en tu PC |
# 1. Clonar el repositorio
git clone https://github.com/zTheNea/ScrcpyGUI.git
cd ScrcpyGUI
# 2. Instalar dependencias de Python
pip install -r requirements.txt
# 3. Ejecutar la aplicación
python scrcpy_gui.pyDescarga el archivo ScrcpyGUI.exe desde la sección de Releases y ejecútalo directamente. No requiere Python instalado.
pip install pyinstaller
pyinstaller ScrcpyGUI.specEl ejecutable se generará dentro del directorio dist/.
- Barra Superior (Topbar): Selector de dispositivos en tiempo real, accesos directos a diagnósticos de hardware (Encoders, Cámaras, Pantallas, Modo PC), botón de actualización y botón de control de ejecución (Iniciar Scrcpy / Detener).
- Barra Lateral (Sidebar): Lista de presets clasificados por categorías, badges descriptivos y tarjeta de estado de versión.
- Área Central (Workspace): Ficha técnica interactiva con estadísticas en tiempo real (Códec, Resolución, FPS, Bitrate), resumen de características y switches rápidos de sesión.
- Dock de Terminal Integrado: Consola monoespaciada para ver comandos generados y registros en vivo con botones para copiar CLI y limpiar salida.
- Al conectar un dispositivo, la aplicación consulta automáticamente vía ADB y scrcpy sus encoders de video compatibles (H.264, H.265, AV1, VP8, VP9), encoders de audio, cámaras físicas y pantallas activas.
- Los menús y opciones se adaptan automáticamente para mostrar únicamente las opciones soportadas por tu teléfono.
- Abre cualquier aplicación instalada en tu móvil en una pantalla secundaria aislada con resolución de tablet y control por hardware UHID.
- Búsqueda en tiempo real inline: Encuentra y selecciona aplicaciones directamente dentro de la interfaz sin ventanas flotantes secundarias.
- La pantalla virtual se redimensiona automáticamente al tamaño de la ventana en PC sin bordes negros ni deformaciones.
- Detección, descarga e instalación automática de la última versión oficial de scrcpy directamente desde GitHub Releases.
- Selecciona uno de los perfiles en la barra lateral izquierda (ej.
Gaming Pro,Modo Escritorio,App en Pantalla Virtual). - Revisa las métricas en el panel central y presiona
Iniciar Scrcpy.
- Con cable USB previo: Haz clic en
Auto-USBen la pestaña Wi-Fi para conectar automáticamente sin cables. - Sin cable (Android 11+): Empareja ingresando la IP y el código de 6 dígitos en la pestaña Wi-Fi.
- Si necesitas una configuración a medida, selecciona
Personalizadopara acceder a todas las opciones organizadas en pestañas (Video, Audio, Pantalla, Controles, Wi-Fi, Perfiles).
¿Necesito rootear mi teléfono?
No. ScrcpyGUI y scrcpy funcionan completamente sin root. Solo necesitas activar la Depuración USB en las Opciones de Desarrollador.
¿Mi teléfono deja de funcionar mientras uso scrcpy?
No. Tu teléfono sigue funcionando normalmente. scrcpy solo lee la pantalla y envía eventos de entrada. Puedes usar el teléfono al mismo tiempo.
¿Funciona con cualquier marca de teléfono?
Sí, funciona con Samsung, Xiaomi, Motorola, OnePlus, Google Pixel, Huawei, Oppo, Realme, Nothing y cualquier teléfono que ejecute Android 5.0 o superior y tenga Depuración USB.
¿Se consume la batería del teléfono?
Si estás conectado por USB, el teléfono se carga al mismo tiempo. Por Wi-Fi, el consumo es equivalente al de una transmisión de video.
¿Puedo usar el teclado y ratón de mi PC para controlar el teléfono?
Sí. ScrcpyGUI soporta múltiples modos de control: inyección de teclado/ratón vía ADB, modo UHID (hardware nativo en Android 13+) y modo OTG (hardware puro USB). El modo se configura desde el preset o en la pestaña Controles.
¿Puedo jugar juegos móviles con teclado y ratón?
Sí. El modo Gaming Pro está optimizado para esto, con baja latencia (120 FPS), inyección por hardware UHID y sin audio para reducir el delay al mínimo.
ScrcpyGUI/
├── scrcpy_gui.py # Interfaz gráfica principal (CustomTkinter)
├── scrcpy_manager.py # Lógica de ADB, red, descargas y hardware
├── command_builder.py # Generador de argumentos CLI de scrcpy
├── config_manager.py # Persistencia de configuración y perfiles
├── presets.py # Presets y paleta de colores
├── paths.py # Rutas centralizadas del sistema
├── strings.py # Textos de la interfaz (localización)
├── gui/
│ ├── __init__.py
│ └── widgets.py # Componentes reutilizables (InlineAppPicker, etc.)
├── tests/
│ ├── test_command_builder.py
│ ├── test_config_manager.py
│ ├── test_preset_filtering.py
│ ├── test_scrcpy_manager.py
│ └── test_paths.py
├── requirements.txt # Dependencias de Python
├── ScrcpyGUI.spec # Configuración de PyInstaller
└── LICENSE # Licencia MIT
Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.
Desarrollado por zTheNea — Agosto 2026