Solo se garantiza que el archivo [README](README.md) original esté actualizado. # scrcpy (v1.17) Esta aplicación proporciona imagen y control de un dispositivo Android conectado por USB (o [por TCP/IP][article-tcpip]). No requiere acceso _root_. Compatible con _GNU/Linux_, _Windows_ y _macOS_. ![screenshot](assets/screenshot-debian-600.jpg) Sus características principales son: - **ligero** (nativo, solo muestra la imagen del dispositivo) - **desempeño** (30~60fps) - **calidad** (1920×1080 o superior) - **baja latencia** ([35~70ms][lowlatency]) - **corto tiempo de inicio** (~1 segundo para mostrar la primera imagen) - **no intrusivo** (no se deja nada instalado en el dispositivo) [lowlatency]: https://github.com/Genymobile/scrcpy/pull/646 ## Requisitos El dispositivo Android requiere como mínimo API 21 (Android 5.0). Asegurate de [habilitar el adb debugging][enable-adb] en tu(s) dispositivo(s). [enable-adb]: https://developer.android.com/studio/command-line/adb.html#Enabling En algunos dispositivos, también necesitas habilitar [una opción adicional][control] para controlarlo con el teclado y ratón. [control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323 ## Consigue la app Packaging status ### Resumen - Linux: `apt install scrcpy` - Windows: [download](README.md#windows) - macOS: `brew install scrcpy` Construir desde la fuente: [BUILD] ([proceso simplificado][BUILD_simple]) [BUILD]: BUILD.md [BUILD_simple]: BUILD.md#simple ### Linux En Debian (_test_ y _sid_ por ahora) y Ubuntu (20.04): ``` apt install scrcpy ``` Hay un paquete [Snap]: [`scrcpy`][snap-link]. [snap-link]: https://snapstats.org/snaps/scrcpy [snap]: https://en.wikipedia.org/wiki/Snappy_(package_manager) Para Fedora, hay un paquete [COPR]: [`scrcpy`][copr-link]. [COPR]: https://fedoraproject.org/wiki/Category:Copr [copr-link]: https://copr.fedorainfracloud.org/coprs/zeno/scrcpy/ Para Arch Linux, hay un paquete [AUR]: [`scrcpy`][aur-link]. [AUR]: https://wiki.archlinux.org/index.php/Arch_User_Repository [aur-link]: https://aur.archlinux.org/packages/scrcpy/ Para Gentoo, hay un paquete [Ebuild]: [`scrcpy/`][ebuild-link]. [Ebuild]: https://wiki.gentoo.org/wiki/Ebuild [ebuild-link]: https://github.com/maggu2810/maggu2810-overlay/tree/master/app-mobilephone/scrcpy También puedes [construir la aplicación manualmente][BUILD] ([proceso simplificado][BUILD_simple]). ### Windows Para Windows, por simplicidad, hay un pre-compilado con todas las dependencias (incluyendo `adb`): - [README](README.md#windows) También está disponible en [Chocolatey]: [Chocolatey]: https://chocolatey.org/ ```bash choco install scrcpy choco install adb # si aún no está instalado ``` Y en [Scoop]: ```bash scoop install scrcpy scoop install adb # si aún no está instalado ``` [Scoop]: https://scoop.sh También puedes [construir la aplicación manualmente][BUILD]. ### macOS La aplicación está disponible en [Homebrew]. Solo instalala: [Homebrew]: https://brew.sh/ ```bash brew install scrcpy ``` Necesitarás `adb`, accesible desde `PATH`. Si aún no lo tienes: ```bash brew install android-platform-tools ``` También está disponible en [MacPorts], que configurará el adb automáticamente: ```bash sudo port install scrcpy ``` [MacPorts]: https://www.macports.org/ También puedes [construir la aplicación manualmente][BUILD]. ## Ejecutar Enchufa el dispositivo Android, y ejecuta: ```bash scrcpy ``` Acepta argumentos desde la línea de comandos, listados en: ```bash scrcpy --help ``` ## Características ### Capturar configuración #### Reducir la definición A veces es útil reducir la definición de la imagen del dispositivo Android para aumentar el desempeño. Para limitar el ancho y la altura a un valor específico (ej. 1024): ```bash scrcpy --max-size 1024 scrcpy -m 1024 # versión breve ``` La otra dimensión es calculada para conservar el aspect ratio del dispositivo. De esta forma, un dispositivo en 1920×1080 será transmitido a 1024×576. #### Cambiar el bit-rate El bit-rate por defecto es 8 Mbps. Para cambiar el bit-rate del video (ej. a 2 Mbps): ```bash scrcpy --bit-rate 2M scrcpy -b 2M # versión breve ``` #### Limitar los fps El fps puede ser limitado: ```bash scrcpy --max-fps 15 ``` Es oficialmente soportado desde Android 10, pero puede funcionar en versiones anteriores. #### Recortar La imagen del dispositivo puede ser recortada para transmitir solo una parte de la pantalla. Por ejemplo, puede ser útil para transmitir la imagen de un solo ojo del Oculus Go: ```bash scrcpy --crop 1224:1440:0:0 # 1224x1440 con coordenadas de origen en (0,0) ``` Si `--max-size` también está especificado, el cambio de tamaño es aplicado después de cortar. #### Fijar la rotación del video Para fijar la rotación de la transmisión: ```bash scrcpy --lock-video-orientation 0 # orientación normal scrcpy --lock-video-orientation 1 # 90° contrarreloj scrcpy --lock-video-orientation 2 # 180° scrcpy --lock-video-orientation 3 # 90° sentido de las agujas del reloj ``` Esto afecta la rotación de la grabación. La [ventana también puede ser rotada](#rotación) independientemente. #### Codificador Algunos dispositivos pueden tener más de una rotación, y algunos pueden causar problemas o errores. Es posible seleccionar un codificador diferente: ```bash scrcpy --encoder OMX.qcom.video.encoder.avc ``` Para listar los codificadores disponibles, puedes pasar un nombre de codificador inválido, el error te dará los codificadores disponibles: ```bash scrcpy --encoder _ ``` ### Grabación Es posible grabar la pantalla mientras se transmite: ```bash scrcpy --record file.mp4 scrcpy -r file.mkv ``` Para grabar sin transmitir la pantalla: ```bash scrcpy --no-display --record file.mp4 scrcpy -Nr file.mkv # interrumpe la grabación con Ctrl+C ``` "Skipped frames" son grabados, incluso si no son mostrados en tiempo real (por razones de desempeño). Los frames tienen _marcas de tiempo_ en el dispositivo, por lo que el "[packet delay variation]" no impacta el archivo grabado. [packet delay variation]: https://en.wikipedia.org/wiki/Packet_delay_variation ### Conexión #### Inalámbrica _Scrcpy_ usa `adb` para comunicarse con el dispositivo, y `adb` puede [conectarse] vía TCP/IP: 1. Conecta el dispositivo al mismo Wi-Fi que tu computadora. 2. Obtén la dirección IP del dispositivo, en Ajustes → Acerca del dispositivo → Estado, o ejecutando este comando: ```bash adb shell ip route | awk '{print $9}' ``` 3. Habilita adb vía TCP/IP en el dispositivo: `adb tcpip 5555`. 4. Desenchufa el dispositivo. 5. Conéctate a tu dispositivo: `adb connect IP_DEL_DISPOSITIVO:5555` _(reemplaza `IP_DEL_DISPOSITIVO`)_. 6. Ejecuta `scrcpy` con normalidad. Podría resultar útil reducir el bit-rate y la definición: ```bash scrcpy --bit-rate 2M --max-size 800 scrcpy -b2M -m800 # versión breve ``` [conectarse]: https://developer.android.com/studio/command-line/adb.html#wireless #### Múltiples dispositivos Si hay muchos dispositivos listados en `adb devices`, será necesario especificar el _número de serie_: ```bash scrcpy --serial 0123456789abcdef scrcpy -s 0123456789abcdef # versión breve ``` Si el dispositivo está conectado por TCP/IP: ```bash scrcpy --serial 192.168.0.1:5555 scrcpy -s 192.168.0.1:5555 # versión breve ``` Puedes iniciar múltiples instancias de _scrcpy_ para múltiples dispositivos. #### Autoiniciar al detectar dispositivo Puedes utilizar [AutoAdb]: ```bash autoadb scrcpy -s '{}' ``` [AutoAdb]: https://github.com/rom1v/autoadb #### Túnel SSH Para conectarse a un dispositivo remoto, es posible conectar un cliente local de `adb` a un servidor remoto `adb` (siempre y cuando utilicen la misma versión de protocolos _adb_): ```bash adb kill-server # cierra el servidor local adb en 5037 ssh -CN -L5037:localhost:5037 -R27183:localhost:27183 your_remote_computer # conserva este servidor abierto ``` Desde otra terminal: ```bash scrcpy ``` Para evitar habilitar "remote port forwarding", puedes forzar una "forward connection" (nótese el argumento `-L` en vez de `-R`): ```bash adb kill-server # cierra el servidor local adb en 5037 ssh -CN -L5037:localhost:5037 -L27183:localhost:27183 your_remote_computer # conserva este servidor abierto ``` Desde otra terminal: ```bash scrcpy --force-adb-forward ``` Al igual que las conexiones inalámbricas, puede resultar útil reducir la calidad: ``` scrcpy -b2M -m800 --max-fps 15 ``` ### Configuración de la ventana #### Título Por defecto, el título de la ventana es el modelo del dispositivo. Puede ser modificado: ```bash scrcpy --window-title 'My device' ``` #### Posición y tamaño La posición y tamaño inicial de la ventana puede ser especificado: ```bash scrcpy --window-x 100 --window-y 100 --window-width 800 --window-height 600 ``` #### Sin bordes Para deshabilitar el diseño de la ventana: ```bash scrcpy --window-borderless ``` #### Siempre adelante Para mantener la ventana de scrcpy siempre adelante: ```bash scrcpy --always-on-top ``` #### Pantalla completa La aplicación puede ser iniciada en pantalla completa: ```bash scrcpy --fullscreen scrcpy -f # versión breve ``` Puede entrar y salir de la pantalla completa con la combinación MOD+f. #### Rotación Se puede rotar la ventana: ```bash scrcpy --rotation 1 ``` Los valores posibles son: - `0`: sin rotación - `1`: 90 grados contrarreloj - `2`: 180 grados - `3`: 90 grados en sentido de las agujas del reloj La rotación también puede ser modificada con la combinación de teclas MOD+← _(izquierda)_ y MOD+→ _(derecha)_. Nótese que _scrcpy_ maneja 3 diferentes rotaciones: - MOD+r solicita al dispositivo cambiar entre vertical y horizontal (la aplicación en uso puede rechazarlo si no soporta la orientación solicitada). - [`--lock-video-orientation`](#fijar-la-rotación-del-video) cambia la rotación de la transmisión (la orientación del video enviado a la PC). Esto afecta a la grabación. - `--rotation` (o MOD+←/MOD+→) rota solo el contenido de la imagen. Esto solo afecta a la imagen mostrada, no a la grabación. ### Otras opciones menores #### Solo lectura ("Read-only") Para deshabilitar los controles (todo lo que interactúe con el dispositivo: eventos del teclado, eventos del mouse, arrastrar y soltar archivos): ```bash scrcpy --no-control scrcpy -n # versión breve ``` #### Pantalla Si múltiples pantallas están disponibles, es posible elegir cual transmitir: ```bash scrcpy --display 1 ``` Los ids de las pantallas se pueden obtener con el siguiente comando: ```bash adb shell dumpsys display # busque "mDisplayId=" en la respuesta ``` La segunda pantalla solo puede ser manejada si el dispositivo cuenta con Android 10 (en caso contrario será transmitida en el modo solo lectura). #### Permanecer activo Para evitar que el dispositivo descanse después de un tiempo mientras está conectado: ```bash scrcpy --stay-awake scrcpy -w # versión breve ``` La configuración original se restaura al cerrar scrcpy. #### Apagar la pantalla Es posible apagar la pantalla mientras se transmite al iniciar con el siguiente comando: ```bash scrcpy --turn-screen-off scrcpy -S # versión breve ``` O presionando MOD+o en cualquier momento. Para volver a prenderla, presione MOD+Shift+o. En Android, el botón de `POWER` siempre prende la pantalla. Por conveniencia, si `POWER` es enviado vía scrcpy (con click-derecho o MOD+p), esto forzará a apagar la pantalla con un poco de atraso (en la mejor de las situaciones). El botón físico `POWER` seguirá prendiendo la pantalla. También puede resultar útil para evitar que el dispositivo entre en inactividad: ```bash scrcpy --turn-screen-off --stay-awake scrcpy -Sw # versión breve ``` #### Renderizar frames vencidos Por defecto, para minimizar la latencia, _scrcpy_ siempre renderiza el último frame disponible decodificado, e ignora cualquier frame anterior. Para forzar el renderizado de todos los frames (a costo de posible aumento de latencia), use: ```bash scrcpy --render-expired-frames ``` #### Mostrar clicks Para presentaciones, puede resultar útil mostrar los clicks físicos (en el dispositivo físicamente). Android provee esta opción en _Opciones para desarrolladores_. _Scrcpy_ provee una opción para habilitar esta función al iniciar la aplicación y restaurar el valor original al salir: ```bash scrcpy --show-touches scrcpy -t # versión breve ``` Nótese que solo muestra los clicks _físicos_ (con el dedo en el dispositivo). #### Desactivar protector de pantalla Por defecto, scrcpy no evita que el protector de pantalla se active en la computadora. Para deshabilitarlo: ```bash scrcpy --disable-screensaver ``` ### Control #### Rotar pantalla del dispositivo Presione MOD+r para cambiar entre posición vertical y horizontal. Nótese que solo rotará si la aplicación activa soporta la orientación solicitada. #### Copiar y pegar Cuando que el portapapeles de Android cambia, automáticamente se sincroniza al portapapeles de la computadora. Cualquier shortcut con Ctrl es enviado al dispositivo. En particular: - Ctrl+c normalmente copia - Ctrl+x normalmente corta - Ctrl+v normalmente pega (después de la sincronización de portapapeles entre la computadora y el dispositivo) Esto normalmente funciona como es esperado. Sin embargo, este comportamiento depende de la aplicación en uso. Por ejemplo, _Termux_ envía SIGINT con Ctrl+c, y _K-9 Mail_ crea un nuevo mensaje. Para copiar, cortar y pegar, en tales casos (solo soportado en Android >= 7): - MOD+c inyecta `COPY` - MOD+x inyecta `CUT` - MOD+v inyecta `PASTE` (después de la sincronización de portapapeles entre la computadora y el dispositivo) Además, MOD+Shift+v permite inyectar el texto en el portapapeles de la computadora como una secuencia de teclas. Esto es útil cuando el componente no acepta pegado de texto (por ejemplo en _Termux_), pero puede romper caracteres no pertenecientes a ASCII. **AVISO:** Pegar de la computadora al dispositivo (tanto con Ctrl+v o MOD+v) copia el contenido al portapapeles del dispositivo. Como consecuencia, cualquier aplicación de Android puede leer su contenido. Debería evitar pegar contenido sensible (como contraseñas) de esta forma. Algunos dispositivos no se comportan como es esperado al establecer el portapapeles programáticamente. La opción `--legacy-paste` está disponible para cambiar el comportamiento de Ctrl+v y MOD+v para que también inyecten el texto del portapapeles de la computadora como una secuencia de teclas (de la misma forma que MOD+Shift+v). #### Pellizcar para zoom Para simular "pinch-to-zoom": Ctrl+_click-y-mover_. Más precisamente, mantén Ctrl mientras presionas botón izquierdo. Hasta que no se suelte el botón, todos los movimientos del mouse cambiarán el tamaño y rotación del contenido (si es soportado por la app en uso) respecto al centro de la pantalla. Concretamente, scrcpy genera clicks adicionales con un "dedo virtual" en la posición invertida respecto al centro de la pantalla. #### Preferencias de inyección de texto Existen dos tipos de [eventos][textevents] generados al escribir texto: - _key events_, marcando si la tecla es presionada o soltada; - _text events_, marcando si un texto fue introducido. Por defecto, las letras son inyectadas usando _key events_, para que el teclado funcione como es esperado en juegos (típicamente las teclas WASD). Pero esto puede [causar problemas][prefertext]. Si encuentras tales problemas, los puedes evitar con: ```bash scrcpy --prefer-text ``` (Pero esto romperá el comportamiento del teclado en los juegos) [textevents]: https://blog.rom1v.com/2018/03/introducing-scrcpy/#handle-text-input [prefertext]: https://github.com/Genymobile/scrcpy/issues/650#issuecomment-512945343 #### Repetir tecla Por defecto, mantener una tecla presionada genera múltiples _key events_. Esto puede causar problemas de desempeño en algunos juegos, donde estos eventos no tienen sentido de todos modos. Para evitar enviar _key events_ repetidos: ```bash scrcpy --no-key-repeat ``` #### Botón derecho y botón del medio Por defecto, botón derecho ejecuta RETROCEDER (o ENCENDIDO) y botón del medio INICIO. Para inhabilitar estos atajos y enviar los clicks al dispositivo: ```bash scrcpy --forward-all-clicks ``` ### Arrastrar y soltar archivos #### Instalar APKs Para instalar un APK, arrastre y suelte el archivo APK (terminado en `.apk`) a la ventana de _scrcpy_. No hay respuesta visual, un mensaje se escribirá en la consola. #### Enviar archivos al dispositivo Para enviar un archivo a `/sdcard/` en el dispositivo, arrastre y suelte un archivo (no APK) a la ventana de _scrcpy_. No hay respuesta visual, un mensaje se escribirá en la consola. El directorio de destino puede ser modificado al iniciar: ```bash scrcpy --push-target=/sdcard/Download/ ``` ### Envío de Audio _Scrcpy_ no envía el audio. Use [sndcpy]. También lea [issue #14]. [sndcpy]: https://github.com/rom1v/sndcpy [issue #14]: https://github.com/Genymobile/scrcpy/issues/14 ## Atajos En la siguiente lista, MOD es el atajo modificador. Por defecto es Alt (izquierdo) o Super (izquierdo). Se puede modificar usando `--shortcut-mod`. Las posibles teclas son `lctrl` (izquierdo), `rctrl` (derecho), `lalt` (izquierdo), `ralt` (derecho), `lsuper` (izquierdo) y `rsuper` (derecho). Por ejemplo: ```bash # use RCtrl para los atajos scrcpy --shortcut-mod=rctrl # use tanto LCtrl+LAlt o LSuper para los atajos scrcpy --shortcut-mod=lctrl+lalt,lsuper ``` _[Super] es generalmente la tecla Windows o Cmd._ [Super]: https://en.wikipedia.org/wiki/Super_key_(keyboard_button) | Acción | Atajo | ------------------------------------------- |:----------------------------- | Alterne entre pantalla compelta | MOD+f | Rotar pantalla hacia la izquierda | MOD+← _(izquierda)_ | Rotar pantalla hacia la derecha | MOD+→ _(derecha)_ | Ajustar ventana a 1:1 ("pixel-perfect") | MOD+g | Ajustar ventana para quitar los bordes negros| MOD+w \| _Doble click¹_ | Click en `INICIO` | MOD+h \| _Botón del medio_ | Click en `RETROCEDER` | MOD+b \| _Botón derecho²_ | Click en `CAMBIAR APLICACIÓN` | MOD+s | Click en `MENÚ` (desbloquear pantalla) | MOD+m | Click en `SUBIR VOLUMEN` | MOD+↑ _(arriba)_ | Click en `BAJAR VOLUME` | MOD+↓ _(abajo)_ | Click en `ENCENDIDO` | MOD+p | Encendido | _Botón derecho²_ | Apagar pantalla (manteniendo la transmisión)| MOD+o | Encender pantalla | MOD+Shift+o | Rotar pantalla del dispositivo | MOD+r | Abrir panel de notificaciones | MOD+n | Cerrar panel de notificaciones | MOD+Shift+n | Copiar al portapapeles³ | MOD+c | Cortar al portapapeles³ | MOD+x | Synchronizar portapapeles y pegar³ | MOD+v | inyectar texto del portapapeles de la PC | MOD+Shift+v | Habilitar/Deshabilitar contador de FPS (en stdout) | MOD+i | Pellizcar para zoom | Ctrl+_click-y-mover_ _¹Doble click en los bordes negros para eliminarlos._ _²Botón derecho enciende la pantalla si estaba apagada, sino ejecuta RETROCEDER._ _³Solo en Android >= 7._ Todos los atajos Ctrl+_tecla_ son enviados al dispositivo para que sean manejados por la aplicación activa. ## Path personalizado Para usar un binario de _adb_ en particular, configure el path `ADB` en las variables de entorno: ```bash ADB=/path/to/adb scrcpy ``` Para sobreescribir el path del archivo `scrcpy-server`, configure el path en `SCRCPY_SERVER_PATH`. ## ¿Por qué _scrcpy_? Un colega me retó a encontrar un nombre tan impronunciable como [gnirehtet]. [`strcpy`] copia un **str**ing; `scrcpy` copia un **scr**een. [gnirehtet]: https://github.com/Genymobile/gnirehtet [`strcpy`]: http://man7.org/linux/man-pages/man3/strcpy.3.html ## ¿Cómo construir (BUILD)? Véase [BUILD] (en inglés). ## Problemas generales Vea las [preguntas frecuentes (en inglés)](FAQ.md). ## Desarrolladores Lea la [hoja de desarrolladores (en inglés)](DEVELOP.md). ## Licencia Copyright (C) 2018 Genymobile Copyright (C) 2018-2022 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. ## Artículos - [Introducing scrcpy][article-intro] (en inglés) - [Scrcpy now works wirelessly][article-tcpip] (en inglés) [article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/ [article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/