genymobile/scrcpyMuestra y controla tu dispositivo Android
> [!WARNING]
> **Este repositorio de GitHub (<https://github.com/Genymobile/scrcpy>) es la única fuente oficial del proyecto. No descargues versiones desde sitios web aleatorios, incluso si su nombre contiene `scrcpy`.**
# scrcpy (v5.0.1)
<img src="https://raw.githubusercontent.com/genymobile/scrcpy/HEAD/app/data/scrcpy.svg" width="128" height="128" alt="scrcpy" align="right" />
_se pronuncia "**scr**een **c**o**py**"_
Esta aplicación replica dispositivos Android (vídeo y audio) conectados por USB o
[TCP/IP](https://github.com/genymobile/scrcpy/blob/master/doc/connection.md#tcpip-wireless) y permite controlarlos usando el
teclado y el ratón del ordenador. No requiere acceso _root_ ni una app
instalada en el dispositivo. Funciona en _Linux_, _Windows_ y _macOS_.
[](doc/linux.md)
[](doc/windows.md)
[](doc/macos.md)
Se centra en:
- **ligereza**: nativo, muestra solo la pantalla del dispositivo
- **rendimiento**: 30~120fps, según el dispositivo
- **calidad**: 1920×1080 o superior
- **baja latencia**: [35~70ms][lowlatency]
- **bajo tiempo de arranque**: ~1 segundo para mostrar la primera imagen
- **no intrusivo**: no queda nada instalado en el dispositivo Android
- **beneficios para el usuario**: sin cuenta, sin anuncios, sin necesidad de internet
- **libertad**: software libre y de código abierto
[lowlatency]: https://github.com/Genymobile/scrcpy/pull/646
Sus características incluyen:
- [reenvío de audio](https://github.com/genymobile/scrcpy/blob/master/doc/audio.md) (Android 11+)
- [grabación](https://github.com/genymobile/scrcpy/blob/master/doc/recording.md)
- [pantalla virtual](https://github.com/genymobile/scrcpy/blob/master/doc/virtual-display.md)
- replicación con la [pantalla del dispositivo Android apagada](https://github.com/genymobile/scrcpy/blob/master/doc/device.md#turn-screen-off)
- [copiar y pegar](https://github.com/genymobile/scrcpy/blob/master/doc/control.md#copy-paste) en ambos sentidos
- [calidad configurable](https://github.com/genymobile/scrcpy/blob/master/doc/video.md)
- [replicación de cámara](https://github.com/genymobile/scrcpy/blob/master/doc/camera.md) (Android 12+)
- [replicación como webcam (V4L2)](https://github.com/genymobile/scrcpy/blob/master/doc/v4l2.md) (solo Linux)
- simulación de [teclado][hid-keyboard] y [ratón][hid-mouse] físicos (HID)
- compatibilidad con [gamepad](https://github.com/genymobile/scrcpy/blob/master/doc/gamepad.md)
- [modo OTG](https://github.com/genymobile/scrcpy/blob/master/doc/otg.md)
- y más…
[hid-keyboard]: https://raw.githubusercontent.com/genymobile/scrcpy/master/doc/keyboard.md#physical-keyboard-simulation
[hid-mouse]: https://raw.githubusercontent.com/genymobile/scrcpy/master/doc/mouse.md#physical-mouse-simulation
## Requisitos previos
El dispositivo Android requiere al menos API 21 (Android 5.0).
El [reenvío de audio](https://github.com/genymobile/scrcpy/blob/master/doc/audio.md) es compatible con API >= 30 (Android 11+).
Asegúrate de haber [habilitado la depuración USB][enable-adb] en tu(s) dispositivo(s).
[enable-adb]: https://developer.android.com/studio/debug/dev-options#enable
En algunos dispositivos (especialmente Xiaomi), es posible que aparezca el siguiente error:
```
Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.
```
En ese caso, debe habilitar [una opción adicional][control] `USB debugging
(Security Settings)` (este es un elemento diferente de `USB debugging`) para controlarlo
usando un teclado y un ratón. Es necesario reiniciar el dispositivo una vez que se
establece esta opción.
[control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323
Tenga en cuenta que la depuración USB no es necesaria para ejecutar scrcpy en [modo OTG](https://github.com/genymobile/scrcpy/blob/master/doc/otg.md).
## Obtener la aplicación
- [Linux](https://github.com/genymobile/scrcpy/blob/master/doc/linux.md)
- [Windows](https://github.com/genymobile/scrcpy/blob/master/doc/windows.md) (lea [cómo ejecutar](https://github.com/genymobile/scrcpy/blob/master/doc/windows.md#run))
- [macOS](https://github.com/genymobile/scrcpy/blob/master/doc/macos.md)
## Consejos imprescindibles
- [Reducir la resolución](https://github.com/genymobile/scrcpy/blob/master/doc/video.md#size) puede mejorar enormemente el rendimiento
(`scrcpy -m1024`)
- [_Clic derecho_](https://github.com/genymobile/scrcpy/blob/master/doc/mouse.md#mouse-bindings) activa `BACK`
- [_Clic central_](https://github.com/genymobile/scrcpy/blob/master/doc/mouse.md#mouse-bindings) activa `HOME`
- <kbd>Alt</kbd>+<kbd>f</kbd> alterna la [pantalla completa](https://github.com/genymobile/scrcpy/blob/master/doc/window.md#fullscreen)
- Hay muchos otros [atajos](https://github.com/genymobile/scrcpy/blob/master/doc/shortcuts.md)
## Ejemplos de uso
Hay muchas opciones, [documentadas](#user-documentation) en páginas separadas.
Aquí solo algunos ejemplos comunes.
- Capturar la pantalla en H.265 (mejor calidad), limitar el tamaño a 1920, limitar
la tasa de fotogramas a 60fps, deshabilitar el audio y controlar el dispositivo simulando
un teclado físico:
```bash
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 # versión corta
```
- Iniciar VLC en una nueva pantalla virtual (separada de la pantalla del dispositivo):
```bash
scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
```
- Iniciar VLC en una nueva pantalla _flex_ usando H.265 con una tasa de bits de 16 Mbps,
mientras se mantiene la pantalla activa para que no se apague:
```bash
scrcpy --new-display -x --keep-active --start-app=org.videolan.vlc --video-codec=h265 -b16M
```
- Grabar la cámara del dispositivo en H.265 a 1920x1080 (y el micrófono) en un archivo
MP4:
```bash
scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4
```
- Capturar la cámara frontal del dispositivo y exponerla como webcam en el ordenador (en
Linux):
```bash
scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback
```
- Controlar el dispositivo sin duplicar la pantalla simulando un teclado y
ratón físicos (no se requiere depuración USB):
```bash
scrcpy --otg
```
- Controlar el dispositivo usando mandos de juego conectados al ordenador:
```bash
scrcpy --gamepad=uhid
scrcpy -G # versión corta
```
## Documentación de usuario
La aplicación proporciona muchas funciones y opciones de configuración. Están
documentadas en las siguientes páginas:
- [Conexión](https://github.com/genymobile/scrcpy/blob/master/doc/connection.md)
- [Vídeo](https://github.com/genymobile/scrcpy/blob/master/doc/video.md)
- [Audio](https://github.com/genymobile/scrcpy/blob/master/doc/audio.md)
- [Control](https://github.com/genymobile/scrcpy/blob/master/doc/control.md)
- [Teclado](https://github.com/genymobile/scrcpy/blob/master/doc/keyboard.md)
- [Ratón](https://github.com/genymobile/scrcpy/blob/master/doc/mouse.md)
- [Mando de juego](https://github.com/genymobile/scrcpy/blob/master/doc/gamepad.md)
- [Dispositivo](https://github.com/genymobile/scrcpy/blob/master/doc/device.md)
- [Ventana](https://github.com/genymobile/scrcpy/blob/master/doc/window.md)
- [Grabación](https://github.com/genymobile/scrcpy/blob/master/doc/recording.md)
- [Pantalla virtual](https://github.com/genymobile/scrcpy/blob/master/doc/virtual-display.md)
- [Túneles](https://github.com/genymobile/scrcpy/blob/master/doc/tunnels.md)
- [OTG](https://github.com/genymobile/scrcpy/blob/master/doc/otg.md)
- [Cámara](https://github.com/genymobile/scrcpy/blob/master/doc/camera.md)
- [Video4Linux](https://github.com/genymobile/scrcpy/blob/master/doc/v4l2.md)
- [Atajos](https://github.com/genymobile/scrcpy/blob/master/doc/shortcuts.md)
## Recursos
- [Preguntas frecuentes](https://github.com/genymobile/scrcpy/blob/master/FAQ.md)
- [Traducciones][wiki] (no necesariamente actualizadas)
- [Instrucciones de compilación](https://github.com/genymobile/scrcpy/blob/master/doc/build.md)
- [Desarrolladores](https://github.com/genymobile/scrcpy/blob/master/doc/develop.md)
- [Verificar las firmas de las versiones](https://github.com/genymobile/scrcpy/blob/master/doc/verify-release.md)
[wiki]: https://github.com/Genymobile/scrcpy/wiki
## Artículos
- [Presentando scrcpy][article-intro]
- [Scrcpy ahora funciona de forma inalámbrica][article-tcpip]
- [Scrcpy 2.0, con audio][article-scrcpy2]
[article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/
[article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/
[article-scrcpy2]: https://blog.rom1v.com/2023/03/scrcpy-2-0-with-audio/
## Contacto
Puede abrir un [issue] para informes de errores, solicitudes de funciones o preguntas generales.
Para informes de errores, lea primero las [preguntas frecuentes](https://github.com/genymobile/scrcpy/blob/master/FAQ.md); es posible que encuentre una solución
a su problema de inmediato.
[issue]: https://github.com/Genymobile/scrcpy/issues
También puedes usar:
- Reddit: [`r/scrcpy`](https://www.reddit.com/r/scrcpy)
- BlueSky: [`@scrcpy.bsky.social`](https://bsky.app/profile/scrcpy.bsky.social)
- Twitter: [`@scrcpy_app`](https://twitter.com/scrcpy_app)
## Donar
Soy [@rom1v](https://github.com/rom1v), el autor y mantenedor de _scrcpy_.
Si aprecias esta aplicación, puedes [apoyar mi trabajo de código
abierto][donate]:
- [GitHub Sponsors](https://github.com/sponsors/rom1v)
- [Liberapay](https://liberapay.com/rom1v/)
- [PayPal](https://paypal.me/rom2v)
[donate]: https://blog.rom1v.com/about/#support-my-open-source-work
## Licencia
Copyright (C) 2018 Genymobile
Copyright (C) 2018-2026 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.