> [!WARNING]
> **Este repositório do GitHub (<https://github.com/Genymobile/scrcpy>) é a única fonte oficial
do projeto. Não baixe versões a partir de sites aleatórios, mesmo que
o nome deles contenha `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" />

_pronuncia-se "**scr**een **c**o**py**"_

Esta aplicação espelha dispositivos Android (vídeo e áudio) conectados via USB ou
[TCP/IP](https://github.com/genymobile/scrcpy/blob/master/doc/connection.md#tcpip-wireless) e permite o controle usando o
teclado e o mouse do computador. Não requer acesso _root_ nem um app
instalado no dispositivo. Funciona em _Linux_, _Windows_ e _macOS_.

[![Linux](https://img.shields.io/badge/Linux-download-orange?style=for-the-badge&logo=linux)](doc/linux.md)&nbsp;
[![Windows](https://img.shields.io/badge/Windows-download-blue?style=for-the-badge&logo=windows)](doc/windows.md)&nbsp;
[![macOS](https://img.shields.io/badge/macOS-download-brightgreen?style=for-the-badge&logo=apple)](doc/macos.md)&nbsp;

![screenshot](https://assets.kitploit.com/production/public/readmes/5644/100f9c3d2a94e604729a6e0e13223f4238b3efce1deb88e82bedd16c4c6b337b.jpg)

Ele foca em:

 - **leveza**: nativo, exibe apenas a tela do dispositivo
 - **desempenho**: 30~120fps, dependendo do dispositivo
 - **qualidade**: 1920×1080 ou superior
 - **baixa latência**: [35~70ms][lowlatency]
 - **baixo tempo de inicialização**: ~1 segundo para exibir a primeira imagem
 - **não intrusivo**: nada fica instalado no dispositivo Android
 - **benefícios ao usuário**: sem conta, sem anúncios, sem necessidade de internet
 - **liberdade**: software livre e de código aberto

[lowlatency]: https://github.com/Genymobile/scrcpy/pull/646

Seus recursos incluem:
 - [encaminhamento de áudio](https://github.com/genymobile/scrcpy/blob/master/doc/audio.md) (Android 11+)
 - [gravação](https://github.com/genymobile/scrcpy/blob/master/doc/recording.md)
 - [display virtual](https://github.com/genymobile/scrcpy/blob/master/doc/virtual-display.md)
 - espelhamento com [tela do dispositivo Android desligada](https://github.com/genymobile/scrcpy/blob/master/doc/device.md#turn-screen-off)
 - [copiar-colar](https://github.com/genymobile/scrcpy/blob/master/doc/control.md#copy-paste) em ambas as direções
 - [qualidade configurável](https://github.com/genymobile/scrcpy/blob/master/doc/video.md)
 - [espelhamento de câmera](https://github.com/genymobile/scrcpy/blob/master/doc/camera.md) (Android 12+)
 - [espelhamento como webcam (V4L2)](https://github.com/genymobile/scrcpy/blob/master/doc/v4l2.md) (somente Linux)
 - simulação de [teclado][hid-keyboard] e [mouse][hid-mouse] físicos (HID)
 - suporte a [gamepad](https://github.com/genymobile/scrcpy/blob/master/doc/gamepad.md)
 - [modo OTG](https://github.com/genymobile/scrcpy/blob/master/doc/otg.md)
 - e mais…

[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

## Pré-requisitos

O dispositivo Android requer pelo menos API 21 (Android 5.0).

O [encaminhamento de áudio](https://github.com/genymobile/scrcpy/blob/master/doc/audio.md) é suportado para API >= 30 (Android 11+).

Certifique-se de que você [habilitou a depuração USB][enable-adb] no(s) seu(s) dispositivo(s).

[enable-adb]: https://developer.android.com/studio/debug/dev-options#enable

Em alguns dispositivos (especialmente Xiaomi), você pode receber o seguinte erro:

```
Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.
```

Nesse caso, você precisa habilitar [uma opção adicional][control] `USB debugging
(Security Settings)` (este é um item diferente de `USB debugging`) para controlá-lo
usando teclado e mouse. É necessário reiniciar o dispositivo uma vez que esta
opção seja definida.

[control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323

Observe que a depuração USB não é necessária para executar o scrcpy no [modo OTG](https://github.com/genymobile/scrcpy/blob/master/doc/otg.md).


## Obtenha o aplicativo

 - [Linux](https://github.com/genymobile/scrcpy/blob/master/doc/linux.md)
 - [Windows](https://github.com/genymobile/scrcpy/blob/master/doc/windows.md) (leia [como executar](https://github.com/genymobile/scrcpy/blob/master/doc/windows.md#run))
 - [macOS](https://github.com/genymobile/scrcpy/blob/master/doc/macos.md)


## Dicas essenciais

 - [Reduzir a resolução](https://github.com/genymobile/scrcpy/blob/master/doc/video.md#size) pode melhorar muito o desempenho
   (`scrcpy -m1024`)
 - [_Clique com o botão direito_](https://github.com/genymobile/scrcpy/blob/master/doc/mouse.md#mouse-bindings) aciona `BACK`
 - [_Clique com o botão do meio_](https://github.com/genymobile/scrcpy/blob/master/doc/mouse.md#mouse-bindings) aciona `HOME`
 - <kbd>Alt</kbd>+<kbd>f</kbd> alterna a [tela cheia](https://github.com/genymobile/scrcpy/blob/master/doc/window.md#fullscreen)
 - Existem muitos outros [atalhos](https://github.com/genymobile/scrcpy/blob/master/doc/shortcuts.md)


## Exemplos de uso

Existem muitas opções, [documentadas](#user-documentation) em páginas separadas.
Aqui estão apenas alguns exemplos comuns.

 - Capturar a tela em H.265 (melhor qualidade), limitar o tamanho a 1920, limitar
   a taxa de quadros a 60fps, desativar o áudio e controlar o dispositivo simulando
   um 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  # short version
    ```

 - Iniciar o VLC em uma nova tela virtual (separada da tela do dispositivo):

    ```bash
    scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
    ```

 - Iniciar o VLC em uma nova tela _flex_ usando H.265 com uma taxa de bits de 16 Mbps,
   mantendo a tela ativa para que ela não desligue:

    ```bash
    scrcpy --new-display -x --keep-active --start-app=org.videolan.vlc --video-codec=h265 -b16M
    ```

 - Gravar a câmera do dispositivo em H.265 a 1920x1080 (e o microfone) em um arquivo
   MP4:

    ```bash
    scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4
    ```

 - Capturar a câmera frontal do dispositivo e expô-la como webcam no computador (no
   Linux):

    ```bash
    scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback
    ```

 - Controlar o dispositivo sem espelhamento simulando um teclado e mouse físicos
   (depuração USB não necessária):

    ```bash
    scrcpy --otg
    ```

 - Controlar o dispositivo usando gamepads conectados ao computador:

    ```bash
    scrcpy --gamepad=uhid
    scrcpy -G  # short version
    ```

## Documentação do usuário

O aplicativo oferece muitos recursos e opções de configuração. Eles estão
documentados nas seguintes páginas:

 - [Conexão](https://github.com/genymobile/scrcpy/blob/master/doc/connection.md)
 - [Vídeo](https://github.com/genymobile/scrcpy/blob/master/doc/video.md)
 - [Áudio](https://github.com/genymobile/scrcpy/blob/master/doc/audio.md)
 - [Controle](https://github.com/genymobile/scrcpy/blob/master/doc/control.md)
 - [Teclado](https://github.com/genymobile/scrcpy/blob/master/doc/keyboard.md)
 - [Mouse](https://github.com/genymobile/scrcpy/blob/master/doc/mouse.md)
 - [Gamepad](https://github.com/genymobile/scrcpy/blob/master/doc/gamepad.md)
 - [Dispositivo](https://github.com/genymobile/scrcpy/blob/master/doc/device.md)
 - [Janela](https://github.com/genymobile/scrcpy/blob/master/doc/window.md)
 - [Gravação](https://github.com/genymobile/scrcpy/blob/master/doc/recording.md)
 - [Tela virtual](https://github.com/genymobile/scrcpy/blob/master/doc/virtual-display.md)
 - [Túneis](https://github.com/genymobile/scrcpy/blob/master/doc/tunnels.md)
 - [OTG](https://github.com/genymobile/scrcpy/blob/master/doc/otg.md)
 - [Câmera](https://github.com/genymobile/scrcpy/blob/master/doc/camera.md)
 - [Video4Linux](https://github.com/genymobile/scrcpy/blob/master/doc/v4l2.md)
 - [Atalhos](https://github.com/genymobile/scrcpy/blob/master/doc/shortcuts.md)


## Recursos

 - [FAQ](https://github.com/genymobile/scrcpy/blob/master/FAQ.md)
 - [Traduções][wiki] (não necessariamente atualizadas)
 - [Instruções de compilação](https://github.com/genymobile/scrcpy/blob/master/doc/build.md)
 - [Desenvolvedores](https://github.com/genymobile/scrcpy/blob/master/doc/develop.md)
 - [Verificar assinaturas de lançamento](https://github.com/genymobile/scrcpy/blob/master/doc/verify-release.md)

[wiki]: https://github.com/Genymobile/scrcpy/wiki


## Artigos

- [Apresentando o scrcpy][article-intro]
- [O Scrcpy agora funciona sem fio][article-tcpip]
- [Scrcpy 2.0, com áudio][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/

## Contato

Você pode abrir uma [issue] para relatórios de bugs, solicitações de recursos ou perguntas gerais.

Para relatórios de bugs, leia primeiro o [FAQ](https://github.com/genymobile/scrcpy/blob/master/FAQ.md), você pode encontrar uma solução
para o seu problema imediatamente.

[issue]: https://github.com/Genymobile/scrcpy/issues

Você também pode 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)


## Doar

Sou [@rom1v](https://github.com/rom1v), o autor e mantenedor do _scrcpy_.

Se você gosta deste aplicativo, pode [apoiar meu trabalho de código
aberto][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

## Licença

    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.
Baixar ferramenta
scrcpy

Mais Populares
