+
+### Sommario
+
+ - Linux: `apt install scrcpy`
+ - Windows: [download](README.md#windows)
+ - macOS: `brew install scrcpy`
+
+Compila dai sorgenti: [BUILD] (in inglese) ([procedimento semplificato][BUILD_simple] (in inglese))
+
+[BUILD]: BUILD.md
+[BUILD_simple]: BUILD.md#simple
+
+
+### Linux
+
+Su Debian (_testing_ e _sid_ per ora) e Ubuntu (20.04):
+
+```
+apt install scrcpy
+```
+
+È disponibile anche un pacchetto [Snap]: [`scrcpy`][snap-link].
+
+[snap-link]: https://snapstats.org/snaps/scrcpy
+
+[snap]: https://it.wikipedia.org/wiki/Snappy_(gestore_pacchetti)
+
+Per Fedora, è disponibile un pacchetto [COPR]: [`scrcpy`][copr-link].
+
+[COPR]: https://fedoraproject.org/wiki/Category:Copr
+[copr-link]: https://copr.fedorainfracloud.org/coprs/zeno/scrcpy/
+
+Per Arch Linux, è disponibile un pacchetto [AUR]: [`scrcpy`][aur-link].
+
+[AUR]: https://wiki.archlinux.org/index.php/Arch_User_Repository
+[aur-link]: https://aur.archlinux.org/packages/scrcpy/
+
+Per Gentoo, è disponibile una [Ebuild]: [`scrcpy/`][ebuild-link].
+
+[Ebuild]: https://wiki.gentoo.org/wiki/Ebuild
+[ebuild-link]: https://github.com/maggu2810/maggu2810-overlay/tree/master/app-mobilephone/scrcpy
+
+Puoi anche [compilare l'app manualmente][BUILD] (in inglese) ([procedimento semplificato][BUILD_simple] (in inglese)).
+
+
+### Windows
+
+Per Windows, per semplicità è disponibile un archivio precompilato con tutte le dipendenze (incluso `adb`):
+
+ - [README](README.md#windows) (Link al README originale per l'ultima versione)
+
+È anche disponibile in [Chocolatey]:
+
+[Chocolatey]: https://chocolatey.org/
+
+```bash
+choco install scrcpy
+choco install adb # se non lo hai già
+```
+
+E in [Scoop]:
+
+```bash
+scoop install scrcpy
+scoop install adb # se non lo hai già
+```
+
+[Scoop]: https://scoop.sh
+
+Puoi anche [compilare l'app manualmente][BUILD] (in inglese).
+
+
+### macOS
+
+L'applicazione è disponibile in [Homebrew]. Basta installarlo:
+
+[Homebrew]: https://brew.sh/
+
+```bash
+brew install scrcpy
+```
+
+Serve che `adb` sia accessibile dal tuo `PATH`. Se non lo hai già:
+
+```bash
+brew install android-platform-tools
+```
+
+È anche disponibile in [MacPorts], che imposta adb per te:
+
+```bash
+sudo port install scrcpy
+```
+
+[MacPorts]: https://www.macports.org/
+
+
+Puoi anche [compilare l'app manualmente][BUILD] (in inglese).
+
+
+## Esecuzione
+
+Collega un dispositivo Android ed esegui:
+
+```bash
+scrcpy
+```
+
+Scrcpy accetta argomenti da riga di comando, essi sono listati con:
+
+```bash
+scrcpy --help
+```
+
+## Funzionalità
+
+### Configurazione di acquisizione
+
+#### Riduci dimensione
+
+Qualche volta è utile trasmettere un dispositvo Android ad una definizione inferiore per aumentare le prestazioni.
+
+Per limitare sia larghezza che altezza ad un certo valore (ad es. 1024):
+
+```bash
+scrcpy --max-size 1024
+scrcpy -m 1024 # versione breve
+```
+
+L'altra dimensione è calcolata in modo tale che il rapporto di forma del dispositivo sia preservato.
+In questo esempio un dispositivo in 1920x1080 viene trasmesso a 1024x576.
+
+
+#### Cambia bit-rate (velocità di trasmissione)
+
+Il bit-rate predefinito è 8 Mbps. Per cambiare il bitrate video (ad es. a 2 Mbps):
+
+```bash
+scrcpy --bit-rate 2M
+scrcpy -b 2M # versione breve
+```
+
+#### Limitare il frame rate (frequenza di fotogrammi)
+
+Il frame rate di acquisizione può essere limitato:
+
+```bash
+scrcpy --max-fps 15
+```
+
+Questo è supportato ufficialmente a partire da Android 10, ma potrebbe funzionare in versioni precedenti.
+
+#### Ritaglio
+
+Lo schermo del dispositivo può essere ritagliato per visualizzare solo parte di esso.
+
+Questo può essere utile, per esempio, per trasmettere solo un occhio dell'Oculus Go:
+
+```bash
+scrcpy --crop 1224:1440:0:0 # 1224x1440 at offset (0,0)
+```
+
+Se anche `--max-size` è specificata, il ridimensionamento è applicato dopo il ritaglio.
+
+
+#### Blocca orientamento del video
+
+
+Per bloccare l'orientamento della trasmissione:
+
+```bash
+scrcpy --lock-video-orientation 0 # orientamento naturale
+scrcpy --lock-video-orientation 1 # 90° antiorario
+scrcpy --lock-video-orientation 2 # 180°
+scrcpy --lock-video-orientation 3 # 90° orario
+```
+
+Questo influisce sull'orientamento della registrazione.
+
+
+La [finestra può anche essere ruotata](#rotazione) indipendentemente.
+
+
+#### Codificatore
+
+Alcuni dispositivi hanno più di un codificatore e alcuni di questi possono provocare problemi o crash. È possibile selezionare un encoder diverso:
+
+```bash
+scrcpy --encoder OMX.qcom.video.encoder.avc
+```
+
+Per elencare i codificatori disponibili puoi immettere un nome di codificatore non valido e l'errore mostrerà i codificatori disponibili:
+
+```bash
+scrcpy --encoder _
+```
+
+### Registrazione
+
+È possibile registrare lo schermo durante la trasmissione:
+
+```bash
+scrcpy --record file.mp4
+scrcpy -r file.mkv
+```
+
+Per disabilitare la trasmissione durante la registrazione:
+
+```bash
+scrcpy --no-display --record file.mp4
+scrcpy -Nr file.mkv
+# interrompere la registrazione con Ctrl+C
+```
+
+I "fotogrammi saltati" sono registrati nonostante non siano mostrati in tempo reale (per motivi di prestazioni). I fotogrammi sono _datati_ sul dispositivo, così una [variazione di latenza dei pacchetti][packet delay variation] non impatta il file registrato.
+
+[packet delay variation]: https://en.wikipedia.org/wiki/Packet_delay_variation
+
+
+### Connessione
+
+#### Wireless
+
+
+_Scrcpy_ usa `adb` per comunicare col dispositivo e `adb` può [connettersi][connect] al dispositivo mediante TCP/IP:
+
+1. Connetti il dispositivo alla stessa rete Wi-Fi del tuo computer.
+2. Trova l'indirizzo IP del tuo dispositivo in Impostazioni → Informazioni sul telefono → Stato, oppure eseguendo questo comando:
+
+ ```bash
+ adb shell ip route | awk '{print $9}'
+ ```
+
+3. Abilita adb via TCP/IP sul tuo dispositivo: `adb tcpip 5555`.
+4. Scollega il tuo dispositivo.
+5. Connetti il tuo dispositivo: `adb connect IP_DISPOSITVO:5555` _(rimpiazza `IP_DISPOSITIVO`)_.
+6. Esegui `scrcpy` come al solito.
+
+Potrebbe essere utile diminuire il bit-rate e la definizione
+
+```bash
+scrcpy --bit-rate 2M --max-size 800
+scrcpy -b2M -m800 # versione breve
+```
+
+[connect]: https://developer.android.com/studio/command-line/adb.html#wireless
+
+
+#### Multi dispositivo
+
+Se in `adb devices` sono listati più dispositivi, è necessario specificare il _seriale_:
+
+```bash
+scrcpy --serial 0123456789abcdef
+scrcpy -s 0123456789abcdef # versione breve
+```
+
+Se il dispositivo è collegato mediante TCP/IP:
+
+```bash
+scrcpy --serial 192.168.0.1:5555
+scrcpy -s 192.168.0.1:5555 # versione breve
+```
+
+Puoi avviare più istanze di _scrcpy_ per diversi dispositivi.
+
+
+#### Avvio automativo alla connessione del dispositivo
+
+Potresti usare [AutoAdb]:
+
+```bash
+autoadb scrcpy -s '{}'
+```
+
+[AutoAdb]: https://github.com/rom1v/autoadb
+
+#### Tunnel SSH
+
+Per connettersi a un dispositivo remoto è possibile collegare un client `adb` locale ad un server `adb` remoto (assunto che entrambi stiano usando la stessa versione del protocollo _adb_):
+
+```bash
+adb kill-server # termina il server adb locale su 5037
+ssh -CN -L5037:localhost:5037 -R27183:localhost:27183 your_remote_computer
+# tieni questo aperto
+```
+
+Da un altro terminale:
+
+```bash
+scrcpy
+```
+
+Per evitare l'abilitazione dell'apertura porte remota potresti invece forzare una "forward connection" (notare il `-L` invece di `-R`)
+
+```bash
+adb kill-server # termina il server adb locale su 5037
+ssh -CN -L5037:localhost:5037 -L27183:localhost:27183 your_remote_computer
+# tieni questo aperto
+```
+
+Da un altro terminale:
+
+```bash
+scrcpy --force-adb-forward
+```
+
+
+Come per le connessioni wireless potrebbe essere utile ridurre la qualità:
+
+```
+scrcpy -b2M -m800 --max-fps 15
+```
+
+### Configurazione della finestra
+
+#### Titolo
+
+Il titolo della finestra è il modello del dispositivo per impostazione predefinita. Esso può essere cambiato:
+
+```bash
+scrcpy --window-title 'My device'
+```
+
+#### Posizione e dimensione
+
+La posizione e la dimensione iniziale della finestra può essere specificata:
+
+```bash
+scrcpy --window-x 100 --window-y 100 --window-width 800 --window-height 600
+```
+
+#### Senza bordi
+
+Per disabilitare le decorazioni della finestra:
+
+```bash
+scrcpy --window-borderless
+```
+
+#### Sempre in primo piano
+
+Per tenere scrcpy sempre in primo piano:
+
+```bash
+scrcpy --always-on-top
+```
+
+#### Schermo intero
+
+L'app può essere avviata direttamente a schermo intero:
+
+```bash
+scrcpy --fullscreen
+scrcpy -f # versione breve
+```
+
+Lo schermo intero può anche essere attivato/disattivato con MOD+f.
+
+#### Rotazione
+
+La finestra può essere ruotata:
+
+```bash
+scrcpy --rotation 1
+```
+
+I valori possibili sono:
+ - `0`: nessuna rotazione
+ - `1`: 90 gradi antiorari
+ - `2`: 180 gradi
+ - `3`: 90 gradi orari
+
+La rotazione può anche essere cambiata dinamicamente con MOD+←
+_(sinistra)_ e MOD+→ _(destra)_.
+
+Notare che _scrcpy_ gestisce 3 diversi tipi di rotazione:
+ - MOD+r richiede al dispositvo di cambiare tra orientamento verticale (portrait) e orizzontale (landscape) (l'app in uso potrebbe rifiutarsi se non supporta l'orientamento richiesto).
+ - [`--lock-video-orientation`](#blocca-orientamento-del-video) cambia l'orientamento della trasmissione (l'orientamento del video inviato dal dispositivo al computer). Questo influenza la registrazione.
+ - `--rotation` (o MOD+←/MOD+→) ruota solo il contenuto della finestra. Questo influenza solo la visualizzazione, non la registrazione.
+
+
+### Altre opzioni di trasmissione
+
+#### "Sola lettura"
+
+Per disabilitare i controlli (tutto ciò che può interagire col dispositivo: tasti di input, eventi del mouse, trascina e rilascia (drag&drop) file):
+
+```bash
+scrcpy --no-control
+scrcpy -n
+```
+
+#### Schermo
+
+Se sono disponibili più schermi, è possibile selezionare lo schermo da trasmettere:
+
+```bash
+scrcpy --display 1
+```
+
+La lista degli id schermo può essere ricavata da:
+
+```bash
+adb shell dumpsys display # cerca "mDisplayId=" nell'output
+```
+
+Lo schermo secondario potrebbe essere possibile controllarlo solo se il dispositivo esegue almeno Android 10 (in caso contrario è trasmesso in modalità sola lettura).
+
+
+#### Mantenere sbloccato
+
+Per evitare che il dispositivo si blocchi dopo un po' che il dispositivo è collegato:
+
+```bash
+scrcpy --stay-awake
+scrcpy -w
+```
+
+Lo stato iniziale è ripristinato quando scrcpy viene chiuso.
+
+
+#### Spegnere lo schermo
+
+È possibile spegnere lo schermo del dispositivo durante la trasmissione con un'opzione da riga di comando:
+
+```bash
+scrcpy --turn-screen-off
+scrcpy -S
+```
+
+Oppure premendo MOD+o in qualsiasi momento.
+
+Per riaccenderlo premere MOD+Shift+o.
+
+In Android il pulsante `POWER` (tasto di accensione) accende sempre lo schermo. Per comodità, se `POWER` è inviato via scrcpy (con click destro o con MOD+p), si forza il dispositivo a spegnere lo schermo dopo un piccolo ritardo (appena possibile).
+Il pulsante fisico `POWER` continuerà ad accendere lo schermo normalmente.
+
+Può anche essere utile evitare il blocco del dispositivo:
+
+```bash
+scrcpy --turn-screen-off --stay-awake
+scrcpy -Sw
+```
+
+#### Renderizzare i fotogrammi scaduti
+
+Per minimizzare la latenza _scrcpy_ renderizza sempre l'ultimo fotogramma decodificato disponibile in maniera predefinita e tralascia quelli precedenti.
+
+Per forzare la renderizzazione di tutti i fotogrammi (a costo di una possibile latenza superiore), utilizzare:
+
+```bash
+scrcpy --render-expired-frames
+```
+
+#### Mostrare i tocchi
+
+Per le presentazioni può essere utile mostrare i tocchi fisici (sul dispositivo fisico).
+
+Android fornisce questa funzionalità nelle _Opzioni sviluppatore_.
+
+_Scrcpy_ fornisce un'opzione per abilitare questa funzionalità all'avvio e ripristinare il valore iniziale alla chiusura:
+
+```bash
+scrcpy --show-touches
+scrcpy -t
+```
+
+Notare che mostra solo i tocchi _fisici_ (con le dita sul dispositivo).
+
+
+#### Disabilitare il salvaschermo
+
+In maniera predefinita scrcpy non previene l'attivazione del salvaschermo del computer.
+
+Per disabilitarlo:
+
+```bash
+scrcpy --disable-screensaver
+```
+
+
+### Input di controlli
+
+#### Rotazione dello schermo del dispostivo
+
+Premere MOD+r per cambiare tra le modalità verticale (portrait) e orizzontale (landscape).
+
+Notare che la rotazione avviene solo se l'applicazione in primo piano supporta l'orientamento richiesto.
+
+#### Copia-incolla
+
+Quando gli appunti di Android cambiano, essi vengono automaticamente sincronizzati con gli appunti del computer.
+
+Qualsiasi scorciatoia Ctrl viene inoltrata al dispositivo. In particolare:
+ - Ctrl+c copia
+ - Ctrl+x taglia
+ - Ctrl+v incolla (dopo la sincronizzazione degli appunti da computer a dispositivo)
+
+Questo solitamente funziona nella maniera più comune.
+
+Il comportamento reale, però, dipende dall'applicazione attiva. Per esempio _Termux_ invia SIGINT con Ctrl+c, e _K-9 Mail_ compone un nuovo messaggio.
+
+Per copiare, tagliare e incollare in questi casi (ma è solo supportato in Android >= 7):
+ - MOD+c inietta `COPY`
+ - MOD+x inietta `CUT`
+ - MOD+v inietta `PASTE` (dopo la sincronizzazione degli appunti da computer a dispositivo)
+
+In aggiunta, MOD+Shift+v permette l'iniezione del testo degli appunti del computer come una sequenza di eventi pressione dei tasti. Questo è utile quando il componente non accetta l'incollaggio di testo (per esempio in _Termux_), ma questo può rompere il contenuto non ASCII.
+
+**AVVISO:** Incollare gli appunti del computer nel dispositivo (sia con Ctrl+v che con MOD+v) copia il contenuto negli appunti del dispositivo. Come conseguenza, qualsiasi applicazione Android potrebbe leggere il suo contenuto. Dovresti evitare di incollare contenuti sensibili (come password) in questa maniera.
+
+Alcuni dispositivi non si comportano come aspettato quando si modificano gli appunti del dispositivo a livello di codice. L'opzione `--legacy-paste` è fornita per cambiare il comportamento di Ctrl+v and MOD+v in modo tale che anch'essi iniettino il testo gli appunti del computer come una sequenza di eventi pressione dei tasti (nella stessa maniera di MOD+Shift+v).
+
+#### Pizzica per zoomare (pinch-to-zoom)
+
+Per simulare il "pizzica per zoomare": Ctrl+_click e trascina_.
+
+Più precisamente, tieni premuto Ctrl mentre premi il pulsante sinistro. Finchè il pulsante non sarà rilasciato, tutti i movimenti del mouse ridimensioneranno e ruoteranno il contenuto (se supportato dall'applicazione) relativamente al centro dello schermo.
+
+Concretamente scrcpy genera degli eventi di tocco addizionali di un "dito virtuale" nella posizione simmetricamente opposta rispetto al centro dello schermo.
+
+
+#### Preferenze di iniezione del testo
+
+Ci sono due tipi di [eventi][textevents] generati quando si scrive testo:
+ - _eventi di pressione_, segnalano che tasto è stato premuto o rilasciato;
+ - _eventi di testo_, segnalano che del testo è stato inserito.
+
+In maniera predefinita le lettere sono "iniettate" usando gli eventi di pressione, in maniera tale che la tastiera si comporti come aspettato nei giochi (come accade solitamente per i tasti WASD).
+
+Questo, però, può [causare problemi][prefertext]. Se incontri un problema del genere, puoi evitarlo con:
+
+```bash
+scrcpy --prefer-text
+```
+
+(ma questo romperà il normale funzionamento della tastiera nei giochi)
+
+[textevents]: https://blog.rom1v.com/2018/03/introducing-scrcpy/#handle-text-input
+[prefertext]: https://github.com/Genymobile/scrcpy/issues/650#issuecomment-512945343
+
+
+#### Ripetizione di tasti
+
+In maniera predefinita tenere premuto un tasto genera una ripetizione degli eventi di pressione di tale tasto. Questo può creare problemi di performance in alcuni giochi, dove questi eventi sono inutilizzati.
+
+Per prevenire l'inoltro ripetuto degli eventi di pressione:
+
+```bash
+scrcpy --no-key-repeat
+```
+
+#### Click destro e click centrale
+
+In maniera predefinita, click destro aziona BACK (indietro) e il click centrale aziona HOME. Per disabilitare queste scorciatoie e, invece, inviare i click al dispositivo:
+
+```bash
+scrcpy --forward-all-clicks
+```
+
+
+### Rilascio di file
+
+#### Installare APK
+
+Per installare un APK, trascina e rilascia un file APK (finisce con `.apk`) nella finestra di _scrcpy_.
+
+Non c'è alcuna risposta visiva, un log è stampato nella console.
+
+
+#### Trasferimento di file verso il dispositivo
+
+Per trasferire un file in `/sdcard/` del dispositivo trascina e rilascia un file (non APK) nella finestra di _scrcpy_.
+
+Non c'è alcuna risposta visiva, un log è stampato nella console.
+
+La cartella di destinazione può essere cambiata all'avvio:
+
+```bash
+scrcpy --push-target=/sdcard/Download/
+```
+
+
+### Inoltro dell'audio
+
+L'audio non è inoltrato da _scrcpy_. Usa [sndcpy].
+
+Vedi anche la [issue #14].
+
+[sndcpy]: https://github.com/rom1v/sndcpy
+[issue #14]: https://github.com/Genymobile/scrcpy/issues/14
+
+
+## Scociatoie
+
+Nella lista seguente, MOD è il modificatore delle scorciatoie. In maniera predefinita è Alt (sinistro) o Super (sinistro).
+
+Può essere cambiato usando `--shortcut-mod`. I tasti possibili sono `lctrl`, `rctrl`, `lalt`, `ralt`, `lsuper` and `rsuper` (`l` significa sinistro e `r` significa destro). Per esempio:
+
+```bash
+# usa ctrl destro per le scorciatoie
+scrcpy --shortcut-mod=rctrl
+
+# use sia "ctrl sinistro"+"alt sinistro" che "super sinistro" per le scorciatoie
+scrcpy --shortcut-mod=lctrl+lalt,lsuper
+```
+
+_[Super] è il pulsante Windows o Cmd._
+
+[Super]: https://it.wikipedia.org/wiki/Tasto_Windows
+
+
+ | Azione | Scorciatoia
+ | ------------------------------------------- |:-----------------------------
+ | Schermo intero | MOD+f
+ | Rotazione schermo a sinistra | MOD+← _(sinistra)_
+ | Rotazione schermo a destra | MOD+→ _(destra)_
+ | Ridimensiona finestra a 1:1 (pixel-perfect) | MOD+g
+ | Ridimensiona la finestra per rimuovere i bordi neri | MOD+w \| _Doppio click¹_
+ | Premi il tasto `HOME` | MOD+h \| _Click centrale_
+ | Premi il tasto `BACK` | MOD+b \| _Click destro²_
+ | Premi il tasto `APP_SWITCH` | MOD+s
+ | Premi il tasto `MENU` (sblocca lo schermo) | MOD+m
+ | Premi il tasto `VOLUME_UP` | MOD+↑ _(su)_
+ | Premi il tasto `VOLUME_DOWN` | MOD+↓ _(giù)_
+ | Premi il tasto `POWER` | MOD+p
+ | Accendi | _Click destro²_
+ | Spegni lo schermo del dispositivo (continua a trasmettere) | MOD+o
+ | Accendi lo schermo del dispositivo | MOD+Shift+o
+ | Ruota lo schermo del dispositivo | MOD+r
+ | Espandi il pannello delle notifiche | MOD+n
+ | Chiudi il pannello delle notifiche | MOD+Shift+n
+ | Copia negli appunti³ | MOD+c
+ | Taglia negli appunti³ | MOD+x
+ | Sincronizza gli appunti e incolla³ | MOD+v
+ | Inietta il testo degli appunti del computer | MOD+Shift+v
+ | Abilita/Disabilita il contatore FPS (su stdout) | MOD+i
+ | Pizzica per zoomare | Ctrl+_click e trascina_
+
+_¹Doppio click sui bordi neri per rimuoverli._
+_²Il tasto destro accende lo schermo se era spento, preme BACK in caso contrario._
+_³Solo in Android >= 7._
+
+Tutte le scorciatoie Ctrl+_tasto_ sono inoltrate al dispositivo, così sono gestite dall'applicazione attiva.
+
+## Path personalizzati
+
+Per utilizzare dei binari _adb_ specifici, configura il suo path nella variabile d'ambente `ADB`:
+
+```bash
+ADB=/percorso/per/adb scrcpy
+```
+
+Per sovrascrivere il percorso del file `scrcpy-server`, configura il percorso in `SCRCPY_SERVER_PATH`.
+
+## Perchè _scrcpy_?
+
+Un collega mi ha sfidato a trovare un nome tanto impronunciabile quanto [gnirehtet].
+
+[`strcpy`] copia una **str**ing (stringa); `scrcpy` copia uno **scr**een (schermo).
+
+[gnirehtet]: https://github.com/Genymobile/gnirehtet
+[`strcpy`]: http://man7.org/linux/man-pages/man3/strcpy.3.html
+
+## Come compilare?
+
+Vedi [BUILD] (in inglese).
+
+
+## Problemi comuni
+
+Vedi le [FAQ](FAQ.it.md).
+
+
+## Sviluppatori
+
+Leggi la [pagina per sviluppatori].
+
+[pagina per sviluppatori]: DEVELOP.md
+
+
+## Licenza (in inglese)
+
+ Copyright (C) 2018 Genymobile
+ Copyright (C) 2018-2021 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.
+
+## Articoli (in inglese)
+
+- [Introducendo scrcpy][article-intro]
+- [Scrcpy ora funziona wireless][article-tcpip]
+
+[article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/
+[article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/
diff --git a/README.jp.md b/README.jp.md
new file mode 100644
index 00000000..e42c528e
--- /dev/null
+++ b/README.jp.md
@@ -0,0 +1,725 @@
+_Only the original [README](README.md) is guaranteed to be up-to-date._
+
+# scrcpy (v1.17)
+
+このアプリケーションはUSB(もしくは[TCP/IP経由][article-tcpip])で接続されたAndroidデバイスの表示と制御を提供します。このアプリケーションは _root_ でのアクセスを必要としません。このアプリケーションは _GNU/Linux_ 、 _Windows_ そして _macOS_ 上で動作します。
+
+
+
+以下に焦点を当てています:
+
+ - **軽量** (ネイティブ、デバイス画面表示のみ)
+ - **パフォーマンス** (30~60fps)
+ - **クオリティ** (1920x1080以上)
+ - **低遅延** ([35~70ms][lowlatency])
+ - **短い起動時間** (初回画像を1秒以内に表示)
+ - **非侵入型** (デバイスに何もインストールされていない状態になる)
+
+[lowlatency]: https://github.com/Genymobile/scrcpy/pull/646
+
+
+## 必要要件
+
+AndroidデバイスはAPI21(Android 5.0)以上。
+
+Androidデバイスで[adbデバッグが有効][enable-adb]であること。
+
+[enable-adb]: https://developer.android.com/studio/command-line/adb.html#Enabling
+
+一部のAndroidデバイスでは、キーボードとマウスを使用して制御する[追加オプション][control]を有効にする必要がある。
+
+[control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323
+
+
+## アプリの取得
+
+
+
+### Linux
+
+Debian (_testing_ と _sid_) とUbuntu(20.04):
+
+```
+apt install scrcpy
+```
+
+[Snap]パッケージが利用可能: [`scrcpy`][snap-link]
+
+[snap-link]: https://snapstats.org/snaps/scrcpy
+
+[snap]: https://en.wikipedia.org/wiki/Snappy_(package_manager)
+
+Fedora用[COPR]パッケージが利用可能: [`scrcpy`][copr-link]
+
+[COPR]: https://fedoraproject.org/wiki/Category:Copr
+[copr-link]: https://copr.fedorainfracloud.org/coprs/zeno/scrcpy/
+
+Arch Linux用[AUR]パッケージが利用可能: [`scrcpy`][aur-link]
+
+[AUR]: https://wiki.archlinux.org/index.php/Arch_User_Repository
+[aur-link]: https://aur.archlinux.org/packages/scrcpy/
+
+Gentoo用[Ebuild]が利用可能: [`scrcpy`][ebuild-link]
+
+[Ebuild]: https://wiki.gentoo.org/wiki/Ebuild
+[ebuild-link]: https://github.com/maggu2810/maggu2810-overlay/tree/master/app-mobilephone/scrcpy
+
+[自分でビルド][BUILD]も可能（心配しないでください、それほど難しくはありません。）
+
+
+### Windows
+
+Windowsでは簡単に、（`adb`を含む）すべての依存関係を構築済みのアーカイブを利用可能です。
+
+ - [README](README.md#windows)
+
+[Chocolatey]でも利用可能です:
+
+[Chocolatey]: https://chocolatey.org/
+
+```bash
+choco install scrcpy
+choco install adb # まだ入手していない場合
+```
+
+[Scoop]でも利用可能です:
+
+```bash
+scoop install scrcpy
+scoop install adb # まだ入手していない場合
+```
+
+[Scoop]: https://scoop.sh
+
+また、[アプリケーションをビルド][BUILD]することも可能です。
+
+### macOS
+
+アプリケーションは[Homebrew]で利用可能です。ただインストールするだけです。
+
+[Homebrew]: https://brew.sh/
+
+```bash
+brew install scrcpy
+```
+
+`PATH`から`adb`へのアクセスが必要です。もしまだ持っていない場合:
+
+```bash
+# Homebrew >= 2.6.0
+brew install --cask android-platform-tools
+
+# Homebrew < 2.6.0
+brew cask install android-platform-tools
+```
+
+また、[アプリケーションをビルド][BUILD]することも可能です。
+
+
+## 実行
+
+Androidデバイスを接続し、実行:
+
+```bash
+scrcpy
+```
+
+次のコマンドでリストされるコマンドライン引数も受け付けます:
+
+```bash
+scrcpy --help
+```
+
+## 機能
+
+### キャプチャ構成
+
+#### サイズ削減
+
+Androidデバイスを低解像度でミラーリングする場合、パフォーマンス向上に便利な場合があります。
+
+幅と高さをある値(例：1024)に制限するには:
+
+```bash
+scrcpy --max-size 1024
+scrcpy -m 1024 # 短縮版
+```
+
+一方のサイズはデバイスのアスペクト比が維持されるように計算されます。この方法では、1920x1080のデバイスでは1024x576にミラーリングされます。
+
+
+#### ビットレート変更
+
+ビットレートの初期値は8Mbpsです。ビットレートを変更するには(例:2Mbpsに変更):
+
+```bash
+scrcpy --bit-rate 2M
+scrcpy -b 2M # 短縮版
+```
+
+#### フレームレート制限
+
+キャプチャするフレームレートを制限できます:
+
+```bash
+scrcpy --max-fps 15
+```
+
+この機能はAndroid 10からオフィシャルサポートとなっていますが、以前のバージョンでも動作する可能性があります。
+
+#### トリミング
+
+デバイスの画面は、画面の一部のみをミラーリングするようにトリミングできます。
+
+これは、例えばOculus Goの片方の目をミラーリングする場合に便利です。:
+
+```bash
+scrcpy --crop 1224:1440:0:0 # オフセット位置(0,0)で1224x1440
+```
+
+もし`--max-size`も指定されている場合、トリミング後にサイズ変更が適用されます。
+
+#### ビデオの向きをロックする
+
+ミラーリングの向きをロックするには:
+
+```bash
+scrcpy --lock-video-orientation 0 # 自然な向き
+scrcpy --lock-video-orientation 1 # 90°反時計回り
+scrcpy --lock-video-orientation 2 # 180°
+scrcpy --lock-video-orientation 3 # 90°時計回り
+```
+
+この設定は録画の向きに影響します。
+
+[ウィンドウは独立して回転することもできます](#回転)。
+
+
+#### エンコーダ
+
+いくつかのデバイスでは一つ以上のエンコーダを持ちます。それらのいくつかは、問題やクラッシュを引き起こします。別のエンコーダを選択することが可能です:
+
+
+```bash
+scrcpy --encoder OMX.qcom.video.encoder.avc
+```
+
+利用可能なエンコーダをリストするために、無効なエンコーダ名を渡すことができます。エラー表示で利用可能なエンコーダを提供します。
+
+```bash
+scrcpy --encoder _
+```
+
+### 録画
+
+ミラーリング中に画面の録画をすることが可能です:
+
+```bash
+scrcpy --record file.mp4
+scrcpy -r file.mkv
+```
+
+録画中にミラーリングを無効にするには:
+
+```bash
+scrcpy --no-display --record file.mp4
+scrcpy -Nr file.mkv
+# Ctrl+Cで録画を中断する
+```
+
+"スキップされたフレーム"は(パフォーマンス上の理由で)リアルタイムで表示されなくても録画されます。
+
+フレームはデバイス上で _タイムスタンプされる_ ため [パケット遅延のバリエーション] は録画されたファイルに影響を与えません。
+
+[パケット遅延のバリエーション]: https://en.wikipedia.org/wiki/Packet_delay_variation
+
+
+### 接続
+
+#### ワイヤレス
+
+_Scrcpy_ はデバイスとの通信に`adb`を使用します。そして`adb`はTCP/IPを介しデバイスに[接続]することができます:
+
+1. あなたのコンピュータと同じWi-Fiに接続します。
+2. あなたのIPアドレスを取得します。設定 → 端末情報 → ステータス情報、もしくは、このコマンドを実行します:
+
+ ```bash
+ adb shell ip route | awk '{print $9}'
+ ```
+
+3. あなたのデバイスでTCP/IPを介したadbを有効にします: `adb tcpip 5555`
+4. あなたのデバイスの接続を外します。
+5. あなたのデバイスに接続します:
+ `adb connect DEVICE_IP:5555` _(`DEVICE_IP`は置き換える)_
+6. 通常通り`scrcpy`を実行します。
+
+この方法はビットレートと解像度を減らすのにおそらく有用です:
+
+```bash
+scrcpy --bit-rate 2M --max-size 800
+scrcpy -b2M -m800 # 短縮版
+```
+
+[接続]: https://developer.android.com/studio/command-line/adb.html#wireless
+
+
+#### マルチデバイス
+
+もし`adb devices`でいくつかのデバイスがリストされる場合、 _シリアルナンバー_ を指定する必要があります:
+
+```bash
+scrcpy --serial 0123456789abcdef
+scrcpy -s 0123456789abcdef # 短縮版
+```
+
+デバイスがTCP/IPを介して接続されている場合:
+
+```bash
+scrcpy --serial 192.168.0.1:5555
+scrcpy -s 192.168.0.1:5555 # 短縮版
+```
+
+複数のデバイスに対して、複数の _scrcpy_ インスタンスを開始することができます。
+
+#### デバイス接続での自動起動
+
+[AutoAdb]を使用可能です:
+
+```bash
+autoadb scrcpy -s '{}'
+```
+
+[AutoAdb]: https://github.com/rom1v/autoadb
+
+#### SSHトンネル
+
+リモートデバイスに接続するため、ローカル`adb`クライアントからリモート`adb`サーバーへ接続することが可能です(同じバージョンの _adb_ プロトコルを使用している場合):
+
+```bash
+adb kill-server # 5037ポートのローカルadbサーバーを終了する
+ssh -CN -L5037:localhost:5037 -R27183:localhost:27183 your_remote_computer
+# オープンしたままにする
+```
+
+他の端末から:
+
+```bash
+scrcpy
+```
+
+リモートポート転送の有効化を回避するためには、代わりに転送接続を強制することができます(`-R`の代わりに`-L`を使用することに注意):
+
+```bash
+adb kill-server # 5037ポートのローカルadbサーバーを終了する
+ssh -CN -L5037:localhost:5037 -L27183:localhost:27183 your_remote_computer
+# オープンしたままにする
+```
+
+他の端末から:
+
+```bash
+scrcpy --force-adb-forward
+```
+
+
+ワイヤレス接続と同様に、クオリティを下げると便利な場合があります:
+
+```
+scrcpy -b2M -m800 --max-fps 15
+```
+
+### ウィンドウ構成
+
+#### タイトル
+
+ウィンドウのタイトルはデバイスモデルが初期値です。これは変更できます:
+
+```bash
+scrcpy --window-title 'My device'
+```
+
+#### 位置とサイズ
+
+ウィンドウの位置とサイズの初期値を指定できます:
+
+```bash
+scrcpy --window-x 100 --window-y 100 --window-width 800 --window-height 600
+```
+
+#### ボーダーレス
+
+ウィンドウの装飾を無効化するには:
+
+```bash
+scrcpy --window-borderless
+```
+
+#### 常に画面のトップ
+
+scrcpyの画面を常にトップにするには:
+
+```bash
+scrcpy --always-on-top
+```
+
+#### フルスクリーン
+
+アプリケーションを直接フルスクリーンで開始できます:
+
+```bash
+scrcpy --fullscreen
+scrcpy -f # 短縮版
+```
+
+フルスクリーンは、次のコマンドで動的に切り替えることができます MOD+f
+
+
+#### 回転
+
+ウィンドウは回転することができます:
+
+```bash
+scrcpy --rotation 1
+```
+
+設定可能な値:
+ - `0`: 回転なし
+ - `1`: 90° 反時計回り
+ - `2`: 180°
+ - `3`: 90° 時計回り
+
+回転は次のコマンドで動的に変更することができます。 MOD+←_(左)_ 、 MOD+→_(右)_
+
+_scrcpy_ は3つの回転を管理することに注意:
+ - MOD+rはデバイスに縦向きと横向きの切り替えを要求する(現在実行中のアプリで要求している向きをサポートしていない場合、拒否することがある)
+ - [`--lock-video-orientation`](#ビデオの向きをロックする)は、ミラーリングする向きを変更する(デバイスからPCへ送信される向き)。録画に影響します。
+ - `--rotation` (もしくはMOD+←/MOD+→)は、ウィンドウのコンテンツのみを回転します。これは表示にのみに影響し、録画には影響しません。
+
+### 他のミラーリングオプション
+
+#### Read-only リードオンリー
+
+制御を無効にするには(デバイスと対話する全てのもの:入力キー、マウスイベント、ファイルのドラッグ&ドロップ):
+
+```bash
+scrcpy --no-control
+scrcpy -n
+```
+
+#### ディスプレイ
+
+いくつか利用可能なディスプレイがある場合、ミラーリングするディスプレイを選択できます:
+
+```bash
+scrcpy --display 1
+```
+
+ディスプレイIDのリストは次の方法で取得できます:
+
+```
+adb shell dumpsys display # search "mDisplayId=" in the output
+```
+
+セカンダリディスプレイは、デバイスが少なくともAndroid 10の場合にコントロール可能です。(それ以外ではリードオンリーでミラーリングされます)
+
+
+#### 起動状態にする
+
+デバイス接続時、少し遅れてからデバイスのスリープを防ぐには:
+
+```bash
+scrcpy --stay-awake
+scrcpy -w
+```
+
+scrcpyが閉じられた時、初期状態に復元されます。
+
+#### 画面OFF
+
+コマンドラインオプションを使用することで、ミラーリングの開始時にデバイスの画面をOFFにすることができます:
+
+```bash
+scrcpy --turn-screen-off
+scrcpy -S
+```
+
+もしくは、MOD+oを押すことでいつでもできます。
+
+元に戻すには、MOD+Shift+oを押します。
+
+Androidでは、`POWER`ボタンはいつでも画面を表示します。便宜上、`POWER`がscrcpyを介して(右クリックもしくはMOD+pを介して)送信される場合、(ベストエフォートベースで)少し遅れて、強制的に画面を非表示にします。ただし、物理的な`POWER`ボタンを押した場合は、画面は表示されます。
+
+このオプションはデバイスがスリープしないようにすることにも役立ちます:
+
+```bash
+scrcpy --turn-screen-off --stay-awake
+scrcpy -Sw
+```
+
+
+#### 期限切れフレームをレンダリングする
+
+初期状態では、待ち時間を最小限にするために、_scrcpy_ は最後にデコードされたフレームをレンダリングし、前のフレームを削除します。
+
+全フレームのレンダリングを強制するには(待ち時間が長くなる可能性があります):
+
+```bash
+scrcpy --render-expired-frames
+```
+
+#### タッチを表示
+
+プレゼンテーションの場合(物理デバイス上で)物理的なタッチを表示すると便利な場合があります。
+
+Androidはこの機能を _開発者オプション_ で提供します。
+
+_Scrcpy_ は開始時にこの機能を有効にし、終了時に初期値を復元するオプションを提供します:
+
+```bash
+scrcpy --show-touches
+scrcpy -t
+```
+
+(デバイス上で指を使った) _物理的な_ タッチのみ表示されることに注意してください。
+
+
+#### スクリーンセーバー無効
+
+初期状態では、scrcpyはコンピュータ上でスクリーンセーバーが実行される事を妨げません。
+
+これを無効にするには:
+
+```bash
+scrcpy --disable-screensaver
+```
+
+
+### 入力制御
+
+#### デバイス画面の回転
+
+MOD+rを押すことで、縦向きと横向きを切り替えます。
+
+フォアグラウンドのアプリケーションが要求された向きをサポートしている場合のみ回転することに注意してください。
+
+#### コピー-ペースト
+
+Androidのクリップボードが変更される度に、コンピュータのクリップボードに自動的に同期されます。
+
+Ctrlのショートカットは全てデバイスに転送されます。特に:
+ - Ctrl+c 通常はコピーします
+ - Ctrl+x 通常はカットします
+ - Ctrl+v 通常はペーストします(コンピュータとデバイスのクリップボードが同期された後)
+
+通常は期待通りに動作します。
+
+しかしながら、実際の動作はアクティブなアプリケーションに依存します。例えば、_Termux_ は代わりにCtrl+cでSIGINTを送信します、そして、_K-9 Mail_ は新しいメッセージを作成します。
+
+このようなケースでコピー、カットそしてペーストをするには(Android 7以上でのサポートのみですが):
+ - MOD+c `COPY`を挿入
+ - MOD+x `CUT`を挿入
+ - MOD+v `PASTE`を挿入(コンピュータとデバイスのクリップボードが同期された後)
+
+加えて、MOD+Shift+vはコンピュータのクリップボードテキストにキーイベントのシーケンスとして挿入することを許可します。これはコンポーネントがテキストのペーストを許可しない場合(例えば _Termux_)に有用ですが、非ASCIIコンテンツを壊す可能性があります。
+
+**警告:** デバイスにコンピュータのクリップボードを(Ctrl+vまたはMOD+vを介して)ペーストすることは、デバイスのクリップボードにコンテンツをコピーします。結果としてどのAndoridアプリケーションもそのコンテンツを読み取ることができます。機密性の高いコンテンツ(例えばパスワードなど)をこの方法でペーストすることは避けてください。
+
+プログラムでデバイスのクリップボードを設定した場合、一部のデバイスは期待どおりに動作しません。`--legacy-paste`オプションは、コンピュータのクリップボードテキストをキーイベントのシーケンスとして挿入するため(MOD+Shift+vと同じ方法)、Ctrl+vとMOD+vの動作の変更を提供します。
+
+#### ピンチしてズームする
+
+"ピンチしてズームする"をシミュレートするには: Ctrl+_クリック&移動_
+
+より正確にするには、左クリックボタンを押している間、Ctrlを押したままにします。左クリックボタンを離すまで、全てのマウスの動きは、(アプリでサポートされている場合)画面の中心を基準として、コンテンツを拡大縮小および回転します。
+
+具体的には、scrcpyは画面の中央を反転した位置にある"バーチャルフィンガー"から追加のタッチイベントを生成します。
+
+
+#### テキストインジェクション環境設定
+
+テキストをタイプした時に生成される2種類の[イベント][textevents]があります:
+ - _key events_ はキーを押したときと離したことを通知します。
+ - _text events_ はテキストが入力されたことを通知します。
+
+初期状態で、文字はキーイベントで挿入されるため、キーボードはゲームで期待通りに動作します(通常はWASDキー)。
+
+しかし、これは[問題を引き起こす][prefertext]かもしれません。もしこのような問題が発生した場合は、この方法で回避できます:
+
+```bash
+scrcpy --prefer-text
+```
+
+(しかしこの方法はゲームのキーボードの動作を壊します)
+
+[textevents]: https://blog.rom1v.com/2018/03/introducing-scrcpy/#handle-text-input
+[prefertext]: https://github.com/Genymobile/scrcpy/issues/650#issuecomment-512945343
+
+
+#### キーの繰り返し
+
+初期状態では、キーの押しっぱなしは繰り返しのキーイベントを生成します。これらのイベントが使われない場合でも、この方法は一部のゲームでパフォーマンスの問題を引き起す可能性があります。
+
+繰り返しのキーイベントの転送を回避するためには:
+
+```bash
+scrcpy --no-key-repeat
+```
+
+
+#### 右クリックと真ん中クリック
+
+初期状態では、右クリックはバックの動作(もしくはパワーオン)を起こし、真ん中クリックではホーム画面へ戻ります。このショートカットを無効にし、代わりにデバイスへクリックを転送するには:
+
+```bash
+scrcpy --forward-all-clicks
+```
+
+
+### ファイルのドロップ
+
+#### APKのインストール
+
+APKをインストールするには、(`.apk`で終わる)APKファイルを _scrcpy_ の画面にドラッグ&ドロップします。
+
+見た目のフィードバックはありません。コンソールにログが出力されます。
+
+
+#### デバイスにファイルを送る
+
+デバイスの`/sdcard/`ディレクトリにファイルを送るには、(APKではない)ファイルを _scrcpy_ の画面にドラッグ&ドロップします。
+
+見た目のフィードバックはありません。コンソールにログが出力されます。
+
+転送先ディレクトリを起動時に変更することができます:
+
+```bash
+scrcpy --push-target /sdcard/foo/bar/
+```
+
+
+### 音声転送
+
+音声は _scrcpy_ では転送されません。[sndcpy]を使用します。
+
+[issue #14]も参照ください。
+
+[sndcpy]: https://github.com/rom1v/sndcpy
+[issue #14]: https://github.com/Genymobile/scrcpy/issues/14
+
+
+## ショートカット
+
+次のリストでは、MODでショートカット変更します。初期状態では、(left)Altまたは(left)Superです。
+
+これは`--shortcut-mod`で変更することができます。可能なキーは`lctrl`、`rctrl`、`lalt`、 `ralt`、 `lsuper`そして`rsuper`です。例えば:
+
+```bash
+# RCtrlをショートカットとして使用します
+scrcpy --shortcut-mod=rctrl
+
+# ショートカットにLCtrl+LAltまたはLSuperのいずれかを使用します
+scrcpy --shortcut-mod=lctrl+lalt,lsuper
+```
+
+_[Super]は通常WindowsもしくはCmdキーです。_
+
+[Super]: https://en.wikipedia.org/wiki/Super_key_(keyboard_button)
+
+ | アクション | ショートカット
+ | ------------------------------------------- |:-----------------------------
+ | フルスクリーンモードへの切り替え | MOD+f
+ | ディスプレイを左に回転 | MOD+← _(左)_
+ | ディスプレイを右に回転 | MOD+→ _(右)_
+ | ウィンドウサイズを変更して1:1に変更(ピクセルパーフェクト) | MOD+g
+ | ウィンドウサイズを変更して黒い境界線を削除 | MOD+w \| _ダブルクリック¹_
+ | `HOME`をクリック | MOD+h \| _真ん中クリック_
+ | `BACK`をクリック | MOD+b \| _右クリック²_
+ | `APP_SWITCH`をクリック | MOD+s
+ | `MENU` (画面のアンロック)をクリック | MOD+m
+ | `VOLUME_UP`をクリック | MOD+↑ _(上)_
+ | `VOLUME_DOWN`をクリック | MOD+↓ _(下)_
+ | `POWER`をクリック | MOD+p
+ | 電源オン | _右クリック²_
+ | デバイス画面をオフにする(ミラーリングしたまま) | MOD+o
+ | デバイス画面をオンにする | MOD+Shift+o
+ | デバイス画面を回転する | MOD+r
+ | 通知パネルを展開する | MOD+n
+ | 通知パネルを折りたたむ | MOD+Shift+n
+ | クリップボードへのコピー³ | MOD+c
+ | クリップボードへのカット³ | MOD+x
+ | クリップボードの同期とペースト³ | MOD+v
+ | コンピュータのクリップボードテキストの挿入 | MOD+Shift+v
+ | FPSカウンタ有効/無効(標準入出力上) | MOD+i
+ | ピンチしてズームする | Ctrl+_クリック&移動_
+
+_¹黒い境界線を削除するため、境界線上でダブルクリック_
+_²もしスクリーンがオフの場合、右クリックでスクリーンをオンする。それ以外の場合はBackを押します._
+_³Android 7以上のみ._
+
+全てのCtrl+_キー_ ショートカットはデバイスに転送されます、そのためアクティブなアプリケーションによって処理されます。
+
+
+## カスタムパス
+
+特定の _adb_ バイナリを使用する場合、そのパスを環境変数`ADB`で構成します:
+
+ ADB=/path/to/adb scrcpy
+
+`scrcpy-server`ファイルのパスを上書きするには、`SCRCPY_SERVER_PATH`でそのパスを構成します。
+
+[useful]: https://github.com/Genymobile/scrcpy/issues/278#issuecomment-429330345
+
+
+## なぜ _scrcpy_?
+
+同僚が私に、[gnirehtet]のように発音できない名前を見つけるように要求しました。
+
+[`strcpy`]は**str**ingをコピーします。`scrcpy`は**scr**eenをコピーします。
+
+[gnirehtet]: https://github.com/Genymobile/gnirehtet
+[`strcpy`]: http://man7.org/linux/man-pages/man3/strcpy.3.html
+
+
+## ビルド方法は?
+
+[BUILD]を参照してください。
+
+[BUILD]: BUILD.md
+
+
+## よくある質問
+
+[FAQ](FAQ.md)を参照してください。
+
+
+## 開発者
+
+[開発者のページ]を読んでください。
+
+[開発者のページ]: DEVELOP.md
+
+
+## ライセンス
+
+ Copyright (C) 2018 Genymobile
+ Copyright (C) 2018-2021 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.
+
+## 記事
+
+- [Introducing scrcpy][article-intro]
+- [Scrcpy now works wirelessly][article-tcpip]
+
+[article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/
+[article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/
diff --git a/README.ko.md b/README.ko.md
index b232accd..31e38c6f 100644
--- a/README.ko.md
+++ b/README.ko.md
@@ -1,3 +1,5 @@
+_Only the original [README](README.md) is guaranteed to be up-to-date._
+
# scrcpy (v1.11)
This document will be updated frequently along with the original Readme file
@@ -66,9 +68,7 @@ Gentoo에서 ,[Ebuild] 가 가능합니다 : [`scrcpy/`][ebuild-link].
윈도우 상에서, 간단하게 설치하기 위해 종속성이 있는 사전 구축된 아카이브가 제공됩니다 (`adb` 포함) :
해당 파일은 Readme원본 링크를 통해서 다운로드가 가능합니다.
- - [`scrcpy-win`][direct-win]
-
-[direct-win]: https://github.com/Genymobile/scrcpy/blob/master/README.md#windows
+ - [README](README.md#windows)
[어플을 직접 설치][BUILD] 할 수도 있습니다.
@@ -112,7 +112,7 @@ scrcpy --help
### 캡쳐 환경 설정
-###사이즈 재정의
+### 사이즈 재정의
가끔씩 성능을 향상시키기위해 안드로이드 디바이스를 낮은 해상도에서 미러링하는 것이 유용할 때도 있습니다.
@@ -136,7 +136,7 @@ scrcpy --bit-rate 2M
scrcpy -b 2M # 축약 버전
```
-###프레임 비율 제한
+### 프레임 비율 제한
안드로이드 버전 10이상의 디바이스에서는, 다음의 명령어로 캡쳐 화면의 프레임 비율을 제한할 수 있습니다:
@@ -475,7 +475,7 @@ _²화면이 꺼진 상태에서 우클릭 시 다시 켜지며, 그 외의 상
## 라이선스
Copyright (C) 2018 Genymobile
- Copyright (C) 2018-2020 Romain Vimont
+ Copyright (C) 2018-2021 Romain Vimont
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
diff --git a/README.md b/README.md
index ae947cd8..c83cafeb 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,6 @@
-# scrcpy (v1.12.1)
+# scrcpy (v1.18)
+
+[Read in another language](#translations)
This application provides display and control of Android devices connected on
USB (or [over TCP/IP][article-tcpip]). It does not require any _root_ access.
@@ -34,10 +36,23 @@ control it using keyboard and mouse.
## Get the app
+
+
+### Summary
+
+ - Linux: `apt install scrcpy`
+ - Windows: [download][direct-win64]
+ - macOS: `brew install scrcpy`
+
+Build from sources: [BUILD] ([simplified process][BUILD_simple])
+
+[BUILD]: BUILD.md
+[BUILD_simple]: BUILD.md#simple
+
### Linux
-In Debian (_testing_ and _sid_ for now):
+On Debian (_testing_ and _sid_ for now) and Ubuntu (20.04):
```
apt install scrcpy
@@ -49,6 +64,11 @@ A [Snap] package is available: [`scrcpy`][snap-link].
[snap]: https://en.wikipedia.org/wiki/Snappy_(package_manager)
+For Fedora, a [COPR] package is available: [`scrcpy`][copr-link].
+
+[COPR]: https://fedoraproject.org/wiki/Category:Copr
+[copr-link]: https://copr.fedorainfracloud.org/coprs/zeno/scrcpy/
+
For Arch Linux, an [AUR] package is available: [`scrcpy`][aur-link].
[AUR]: https://wiki.archlinux.org/index.php/Arch_User_Repository
@@ -59,9 +79,8 @@ For Gentoo, an [Ebuild] is available: [`scrcpy/`][ebuild-link].
[Ebuild]: https://wiki.gentoo.org/wiki/Ebuild
[ebuild-link]: https://github.com/maggu2810/maggu2810-overlay/tree/master/app-mobilephone/scrcpy
-You could also [build the app manually][BUILD] (don't worry, it's not that
-hard).
-
+You could also [build the app manually][BUILD] ([simplified
+process][BUILD_simple]).
### Windows
@@ -69,10 +88,10 @@ hard).
For Windows, for simplicity, a prebuilt archive with all the dependencies
(including `adb`) is available:
- - [`scrcpy-win64-v1.12.1.zip`][direct-win64]
- _(SHA-256: 57d34b6d16cfd9fe169bc37c4df58ebd256d05c1ea3febc63d9cb0a027ab47c9)_
+ - [`scrcpy-win64-v1.18.zip`][direct-win64]
+ _(SHA-256: 37212f5087fe6f3e258f1d44fa5c02207496b30e1d7ec442cbcf8358910a5c63)_
-[direct-win64]: https://github.com/Genymobile/scrcpy/releases/download/v1.12.1/scrcpy-win64-v1.12.1.zip
+[direct-win64]: https://github.com/Genymobile/scrcpy/releases/download/v1.18/scrcpy-win64-v1.18.zip
It is also available in [Chocolatey]:
@@ -108,9 +127,18 @@ brew install scrcpy
You need `adb`, accessible from your `PATH`. If you don't have it yet:
```bash
-brew cask install android-platform-tools
+brew install android-platform-tools
```
+It's also available in [MacPorts], which sets up adb for you:
+
+```bash
+sudo port install scrcpy
+```
+
+[MacPorts]: https://www.macports.org/
+
+
You can also [build the app manually][BUILD].
@@ -159,12 +187,14 @@ scrcpy -b 2M # short version
#### Limit frame rate
-On devices with Android >= 10, the capture frame rate can be limited:
+The capture frame rate can be limited:
```bash
scrcpy --max-fps 15
```
+This is officially supported since Android 10, but may work on earlier versions.
+
#### Crop
The device screen may be cropped to mirror only part of the screen.
@@ -178,7 +208,43 @@ scrcpy --crop 1224:1440:0:0 # 1224x1440 at offset (0,0)
If `--max-size` is also specified, resizing is applied after cropping.
-### Recording
+#### Lock video orientation
+
+
+To lock the orientation of the mirroring:
+
+```bash
+scrcpy --lock-video-orientation # initial (current) orientation
+scrcpy --lock-video-orientation=0 # natural orientation
+scrcpy --lock-video-orientation=1 # 90° counterclockwise
+scrcpy --lock-video-orientation=2 # 180°
+scrcpy --lock-video-orientation=3 # 90° clockwise
+```
+
+This affects recording orientation.
+
+The [window may also be rotated](#rotation) independently.
+
+
+#### Encoder
+
+Some devices have more than one encoder, and some of them may cause issues or
+crash. It is possible to select a different encoder:
+
+```bash
+scrcpy --encoder OMX.qcom.video.encoder.avc
+```
+
+To list the available encoders, you could pass an invalid encoder name, the
+error will give the available encoders:
+
+```bash
+scrcpy --encoder _
+```
+
+### Capture
+
+#### Recording
It is possible to record the screen while mirroring:
@@ -193,7 +259,6 @@ To disable mirroring while recording:
scrcpy --no-display --record file.mp4
scrcpy -Nr file.mkv
# interrupt recording with Ctrl+C
-# Ctrl+C does not terminate properly on Windows, so disconnect the device
```
"Skipped frames" are recorded, even if they are not displayed in real time (for
@@ -203,6 +268,59 @@ variation] does not impact the recorded file.
[packet delay variation]: https://en.wikipedia.org/wiki/Packet_delay_variation
+#### v4l2loopback
+
+On Linux, it is possible to send the video stream to a v4l2 loopback device, so
+that the Android device can be opened like a webcam by any v4l2-capable tool.
+
+The module `v4l2loopback` must be installed:
+
+```bash
+sudo apt install v4l2loopback-dkms
+```
+
+To create a v4l2 device:
+
+```bash
+sudo modprobe v4l2loopback
+```
+
+This will create a new video device in `/dev/videoN`, where `N` is an integer
+(more [options](https://github.com/umlaeute/v4l2loopback#options) are available
+to create several devices or devices with specific IDs).
+
+To list the enabled devices:
+
+```bash
+# requires v4l-utils package
+v4l2-ctl --list-devices
+
+# simple but might be sufficient
+ls /dev/video*
+```
+
+To start scrcpy using a v4l2 sink:
+
+```bash
+scrcpy --v4l2-sink=/dev/videoN
+scrcpy --v4l2-sink=/dev/videoN --no-display # disable mirroring window
+scrcpy --v4l2-sink=/dev/videoN -N # short version
+```
+
+(replace `N` by the device ID, check with `ls /dev/video*`)
+
+Once enabled, you can open your video stream with a v4l2-capable tool:
+
+```bash
+ffplay -i /dev/videoN
+vlc v4l2:///dev/videoN # VLC might add some buffering delay
+```
+
+For example, you could capture the video within [OBS].
+
+[OBS]: https://obsproject.com/fr
+
+
### Connection
#### Wireless
@@ -212,7 +330,13 @@ device over TCP/IP:
1. Plug the device into a USB port on your computer.
2. Connect the device to the same Wi-Fi as your computer.
-3. Get your device IP address (in Settings → About phone → Status).
+3. Get your device IP address, in Settings → About phone → Status, or by
+ executing this command:
+
+ ```bash
+ adb shell ip route | awk '{print $9}'
+ ```
+
4. Enable adb over TCP/IP on your device: `adb tcpip 5555`.
5. Unplug your device.
6. Connect to your device: `adb connect DEVICE_IP:5555` _(replace `DEVICE_IP`)_.
@@ -280,6 +404,16 @@ scrcpy -s 192.168.0.1:5555 # short version
You can start several instances of _scrcpy_ for several devices.
+#### Autostart on device connection
+
+You could use [AutoAdb]:
+
+```bash
+autoadb scrcpy -s '{}'
+```
+
+[AutoAdb]: https://github.com/rom1v/autoadb
+
#### SSH tunnel
To connect to a remote device, it is possible to connect a local `adb` client to
@@ -298,6 +432,22 @@ From another terminal:
scrcpy
```
+To avoid enabling remote port forwarding, you could force a forward connection
+instead (notice the `-L` instead of `-R`):
+
+```bash
+adb kill-server # kill the local adb server on 5037
+ssh -CN -L5037:localhost:5037 -L27183:localhost:27183 your_remote_computer
+# keep this open
+```
+
+From another terminal:
+
+```bash
+scrcpy --force-adb-forward
+```
+
+
Like for wireless connections, it may be useful to reduce quality:
```
@@ -347,7 +497,35 @@ scrcpy --fullscreen
scrcpy -f # short version
```
-Fullscreen can then be toggled dynamically with `Ctrl`+`f`.
+Fullscreen can then be toggled dynamically with MOD+f.
+
+#### Rotation
+
+The window may be rotated:
+
+```bash
+scrcpy --rotation 1
+```
+
+Possibles values are:
+ - `0`: no rotation
+ - `1`: 90 degrees counterclockwise
+ - `2`: 180 degrees
+ - `3`: 90 degrees clockwise
+
+The rotation can also be changed dynamically with MOD+←
+_(left)_ and MOD+→ _(right)_.
+
+Note that _scrcpy_ manages 3 different rotations:
+ - MOD+r requests the device to switch between portrait
+ and landscape (the current running app may refuse, if it does not support the
+ requested orientation).
+ - [`--lock-video-orientation`](#lock-video-orientation) changes the mirroring
+ orientation (the orientation of the video sent from the device to the
+ computer). This affects the recording.
+ - `--rotation` (or MOD+←/MOD+→)
+ rotates only the window content. This affects only the display, not the
+ recording.
### Other mirroring options
@@ -362,6 +540,37 @@ scrcpy --no-control
scrcpy -n
```
+#### Display
+
+If several displays are available, it is possible to select the display to
+mirror:
+
+```bash
+scrcpy --display 1
+```
+
+The list of display ids can be retrieved by:
+
+```bash
+adb shell dumpsys display # search "mDisplayId=" in the output
+```
+
+The secondary display may only be controlled if the device runs at least Android
+10 (otherwise it is mirrored in read-only).
+
+
+#### Stay awake
+
+To prevent the device to sleep after some delay when the device is plugged in:
+
+```bash
+scrcpy --stay-awake
+scrcpy -w
+```
+
+The initial state is restored when scrcpy is closed.
+
+
#### Turn screen off
It is possible to turn the device screen off while mirroring on start with a
@@ -372,22 +581,23 @@ scrcpy --turn-screen-off
scrcpy -S
```
-Or by pressing `Ctrl`+`o` at any time.
+Or by pressing MOD+o at any time.
-To turn it back on, press `POWER` (or `Ctrl`+`p`).
+To turn it back on, press MOD+Shift+o.
-#### Render expired frames
+On Android, the `POWER` button always turns the screen on. For convenience, if
+`POWER` is sent via scrcpy (via right-click or MOD+p), it
+will force to turn the screen off after a small delay (on a best effort basis).
+The physical `POWER` button will still cause the screen to be turned on.
-By default, to minimize latency, _scrcpy_ always renders the last decoded frame
-available, and drops any previous one.
-
-To force the rendering of all frames (at a cost of a possible increased
-latency), use:
+It can also be useful to prevent the device from sleeping:
```bash
-scrcpy --render-expired-frames
+scrcpy --turn-screen-off --stay-awake
+scrcpy -Sw
```
+
#### Show touches
For presentations, it may be useful to show physical touches (on the physical
@@ -395,7 +605,8 @@ device).
Android provides this feature in _Developers options_.
-_Scrcpy_ provides an option to enable this feature on start and disable on exit:
+_Scrcpy_ provides an option to enable this feature on start and restore the
+initial value on exit:
```bash
scrcpy --show-touches
@@ -405,24 +616,78 @@ scrcpy -t
Note that it only shows _physical_ touches (with the finger on the device).
+#### Disable screensaver
+
+By default, scrcpy does not prevent the screensaver to run on the computer.
+
+To disable it:
+
+```bash
+scrcpy --disable-screensaver
+```
+
+
### Input control
#### Rotate device screen
-Press `Ctrl`+`r` to switch between portrait and landscape modes.
+Press MOD+r to switch between portrait and landscape
+modes.
Note that it rotates only if the application in foreground supports the
requested orientation.
#### Copy-paste
-It is possible to synchronize clipboards between the computer and the device, in
-both directions:
+Any time the Android clipboard changes, it is automatically synchronized to the
+computer clipboard.
+
+Any Ctrl shortcut is forwarded to the device. In particular:
+ - Ctrl+c typically copies
+ - Ctrl+x typically cuts
+ - Ctrl+v typically pastes (after computer-to-device
+ clipboard synchronization)
+
+This typically works as you expect.
+
+The actual behavior depends on the active application though. For example,
+_Termux_ sends SIGINT on Ctrl+c instead, and _K-9 Mail_
+composes a new message.
+
+To copy, cut and paste in such cases (but only supported on Android >= 7):
+ - MOD+c injects `COPY`
+ - MOD+x injects `CUT`
+ - MOD+v injects `PASTE` (after computer-to-device
+ clipboard synchronization)
+
+In addition, MOD+Shift+v allows to inject the
+computer clipboard text as a sequence of key events. This is useful when the
+component does not accept text pasting (for example in _Termux_), but it can
+break non-ASCII content.
+
+**WARNING:** Pasting the computer clipboard to the device (either via
+Ctrl+v or MOD+v) copies the content
+into the device clipboard. As a consequence, any Android application could read
+its content. You should avoid to paste sensitive content (like passwords) that
+way.
+
+Some devices do not behave as expected when setting the device clipboard
+programmatically. An option `--legacy-paste` is provided to change the behavior
+of Ctrl+v and MOD+v so that they
+also inject the computer clipboard text as a sequence of key events (the same
+way as MOD+Shift+v).
+
+#### Pinch-to-zoom
+
+To simulate "pinch-to-zoom": Ctrl+_click-and-move_.
+
+More precisely, hold Ctrl while pressing the left-click button. Until
+the left-click button is released, all mouse movements scale and rotate the
+content (if supported by the app) relative to the center of the screen.
+
+Concretely, scrcpy generates additional touch events from a "virtual finger" at
+a location inverted through the center of the screen.
- - `Ctrl`+`c` copies the device clipboard to the computer clipboard;
- - `Ctrl`+`Shift`+`v` copies the computer clipboard to the device clipboard;
- - `Ctrl`+`v` _pastes_ the computer clipboard as a sequence of text events (but
- breaks non-ASCII characters).
#### Text injection preference
@@ -446,6 +711,28 @@ scrcpy --prefer-text
[prefertext]: https://github.com/Genymobile/scrcpy/issues/650#issuecomment-512945343
+#### Key repeat
+
+By default, holding a key down generates repeated key events. This can cause
+performance problems in some games, where these events are useless anyway.
+
+To avoid forwarding repeated key events:
+
+```bash
+scrcpy --no-key-repeat
+```
+
+
+#### Right-click and middle-click
+
+By default, right-click triggers BACK (or POWER on) and middle-click triggers
+HOME. To disable these shortcuts and forward the clicks to the device instead:
+
+```bash
+scrcpy --forward-all-clicks
+```
+
+
### File drop
#### Install APK
@@ -458,54 +745,90 @@ There is no visual feedback, a log is printed to the console.
#### Push file to device
-To push a file to `/sdcard/` on the device, drag & drop a (non-APK) file to the
-_scrcpy_ window.
+To push a file to `/sdcard/Download/` on the device, drag & drop a (non-APK)
+file to the _scrcpy_ window.
There is no visual feedback, a log is printed to the console.
The target directory can be changed on start:
```bash
-scrcpy --push-target /sdcard/foo/bar/
+scrcpy --push-target=/sdcard/Movies/
```
### Audio forwarding
-Audio is not forwarded by _scrcpy_. Use [USBaudio] (Linux-only).
+Audio is not forwarded by _scrcpy_. Use [sndcpy].
Also see [issue #14].
-[USBaudio]: https://github.com/rom1v/usbaudio
+[sndcpy]: https://github.com/rom1v/sndcpy
[issue #14]: https://github.com/Genymobile/scrcpy/issues/14
## Shortcuts
- | Action | Shortcut | Shortcut (macOS)
- | -------------------------------------- |:----------------------------- |:-----------------------------
- | Switch fullscreen mode | `Ctrl`+`f` | `Cmd`+`f`
- | Resize window to 1:1 (pixel-perfect) | `Ctrl`+`g` | `Cmd`+`g`
- | Resize window to remove black borders | `Ctrl`+`x` \| _Double-click¹_ | `Cmd`+`x` \| _Double-click¹_
- | Click on `HOME` | `Ctrl`+`h` \| _Middle-click_ | `Ctrl`+`h` \| _Middle-click_
- | Click on `BACK` | `Ctrl`+`b` \| _Right-click²_ | `Cmd`+`b` \| _Right-click²_
- | Click on `APP_SWITCH` | `Ctrl`+`s` | `Cmd`+`s`
- | Click on `MENU` | `Ctrl`+`m` | `Ctrl`+`m`
- | Click on `VOLUME_UP` | `Ctrl`+`↑` _(up)_ | `Cmd`+`↑` _(up)_
- | Click on `VOLUME_DOWN` | `Ctrl`+`↓` _(down)_ | `Cmd`+`↓` _(down)_
- | Click on `POWER` | `Ctrl`+`p` | `Cmd`+`p`
- | Power on | _Right-click²_ | _Right-click²_
- | Turn device screen off (keep mirroring)| `Ctrl`+`o` | `Cmd`+`o`
- | Rotate device screen | `Ctrl`+`r` | `Cmd`+`r`
- | Expand notification panel | `Ctrl`+`n` | `Cmd`+`n`
- | Collapse notification panel | `Ctrl`+`Shift`+`n` | `Cmd`+`Shift`+`n`
- | Copy device clipboard to computer | `Ctrl`+`c` | `Cmd`+`c`
- | Paste computer clipboard to device | `Ctrl`+`v` | `Cmd`+`v`
- | Copy computer clipboard to device | `Ctrl`+`Shift`+`v` | `Cmd`+`Shift`+`v`
- | Enable/disable FPS counter (on stdout) | `Ctrl`+`i` | `Cmd`+`i`
+In the following list, MOD is the shortcut modifier. By default, it's
+(left) Alt or (left) Super.
+
+It can be changed using `--shortcut-mod`. Possible keys are `lctrl`, `rctrl`,
+`lalt`, `ralt`, `lsuper` and `rsuper`. For example:
+
+```bash
+# use RCtrl for shortcuts
+scrcpy --shortcut-mod=rctrl
+
+# use either LCtrl+LAlt or LSuper for shortcuts
+scrcpy --shortcut-mod=lctrl+lalt,lsuper
+```
+
+_[Super] is typically the Windows or Cmd key._
+
+[Super]: https://en.wikipedia.org/wiki/Super_key_(keyboard_button)
+
+ | Action | Shortcut
+ | ------------------------------------------- |:-----------------------------
+ | Switch fullscreen mode | MOD+f
+ | Rotate display left | MOD+← _(left)_
+ | Rotate display right | MOD+→ _(right)_
+ | Resize window to 1:1 (pixel-perfect) | MOD+g
+ | Resize window to remove black borders | MOD+w \| _Double-left-click¹_
+ | Click on `HOME` | MOD+h \| _Middle-click_
+ | Click on `BACK` | MOD+b \| _Right-click²_
+ | Click on `APP_SWITCH` | MOD+s \| _4th-click³_
+ | Click on `MENU` (unlock screen) | MOD+m
+ | Click on `VOLUME_UP` | MOD+↑ _(up)_
+ | Click on `VOLUME_DOWN` | MOD+↓ _(down)_
+ | Click on `POWER` | MOD+p
+ | Power on | _Right-click²_
+ | Turn device screen off (keep mirroring) | MOD+o
+ | Turn device screen on | MOD+Shift+o
+ | Rotate device screen | MOD+r
+ | Expand notification panel | MOD+n \| _5th-click³_
+ | Expand settings panel | MOD+n+n \| _Double-5th-click³_
+ | Collapse panels | MOD+Shift+n
+ | Copy to clipboard⁴ | MOD+c
+ | Cut to clipboard⁴ | MOD+x
+ | Synchronize clipboards and paste⁴ | MOD+v
+ | Inject computer clipboard text | MOD+Shift+v
+ | Enable/disable FPS counter (on stdout) | MOD+i
+ | Pinch-to-zoom | Ctrl+_click-and-move_
_¹Double-click on black borders to remove them._
-_²Right-click turns the screen on if it was off, presses BACK otherwise._
+_²Right-click turns the screen on if it was off, presses BACK otherwise._
+_³4th and 5th mouse buttons, if your mouse has them._
+_⁴Only on Android >= 7._
+
+Shortcuts with repeated keys are executted by releasing and pressing the key a
+second time. For example, to execute "Expand settings panel":
+
+ 1. Press and keep pressing MOD.
+ 2. Then double-press n.
+ 3. Finally, release MOD.
+
+All Ctrl+_key_ shortcuts are forwarded to the device, so they are
+handled by the active application.
## Custom paths
@@ -513,7 +836,9 @@ _²Right-click turns the screen on if it was off, presses BACK otherwise._
To use a specific _adb_ binary, configure its path in the environment variable
`ADB`:
- ADB=/path/to/adb scrcpy
+```bash
+ADB=/path/to/adb scrcpy
+```
To override the path of the `scrcpy-server` file, configure its path in
`SCRCPY_SERVER_PATH`.
@@ -535,8 +860,6 @@ A colleague challenged me to find a name as unpronounceable as [gnirehtet].
See [BUILD].
-[BUILD]: BUILD.md
-
## Common issues
@@ -553,7 +876,7 @@ Read the [developers page].
## Licence
Copyright (C) 2018 Genymobile
- Copyright (C) 2018-2020 Romain Vimont
+ Copyright (C) 2018-2021 Romain Vimont
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -574,3 +897,18 @@ Read the [developers page].
[article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/
[article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/
+
+## Translations
+
+This README is available in other languages:
+
+- [Indonesian (Indonesia, `id`) - v1.16](README.id.md)
+- [Italiano (Italiano, `it`) - v1.17](README.it.md)
+- [日本語 (Japanese, `jp`) - v1.17](README.jp.md)
+- [한국어 (Korean, `ko`) - v1.11](README.ko.md)
+- [português brasileiro (Brazilian Portuguese, `pt-BR`) - v1.17](README.pt-br.md)
+- [Español (Spanish, `sp`) - v1.17](README.sp.md)
+- [简体中文 (Simplified Chinese, `zh-Hans`) - v1.17](README.zh-Hans.md)
+- [繁體中文 (Traditional Chinese, `zh-Hant`) - v1.15](README.zh-Hant.md)
+
+Only this README file is guaranteed to be up-to-date.
diff --git a/README.pt-br.md b/README.pt-br.md
new file mode 100644
index 00000000..3549f0fb
--- /dev/null
+++ b/README.pt-br.md
@@ -0,0 +1,792 @@
+_Apenas o [README](README.md) original é garantido estar atualizado._
+
+# scrcpy (v1.17)
+
+Esta aplicação fornece exibição e controle de dispositivos Android conectados via
+USB (ou [via TCP/IP][article-tcpip]). Não requer nenhum acesso _root_.
+Funciona em _GNU/Linux_, _Windows_ e _macOS_.
+
+
+
+Foco em:
+
+ - **leveza** (nativo, mostra apenas a tela do dispositivo)
+ - **performance** (30~60fps)
+ - **qualidade** (1920×1080 ou acima)
+ - **baixa latência** ([35~70ms][lowlatency])
+ - **baixo tempo de inicialização** (~1 segundo para mostrar a primeira imagem)
+ - **não intrusivo** (nada é deixado instalado no dispositivo)
+
+[lowlatency]: https://github.com/Genymobile/scrcpy/pull/646
+
+
+## Requisitos
+
+O dispositivo Android requer pelo menos a API 21 (Android 5.0).
+
+Tenha certeza de ter [ativado a depuração adb][enable-adb] no(s) seu(s) dispositivo(s).
+
+[enable-adb]: https://developer.android.com/studio/command-line/adb.html#Enabling
+
+Em alguns dispositivos, você também precisa ativar [uma opção adicional][control] para
+controlá-lo usando teclado e mouse.
+
+[control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323
+
+
+## Obter o app
+
+
+
+### Linux
+
+No Debian (_testing_ e _sid_ por enquanto) e Ubuntu (20.04):
+
+```
+apt install scrcpy
+```
+
+Um pacote [Snap] está disponível: [`scrcpy`][snap-link].
+
+[snap-link]: https://snapstats.org/snaps/scrcpy
+
+[snap]: https://en.wikipedia.org/wiki/Snappy_(package_manager)
+
+Para Fedora, um pacote [COPR] está disponível: [`scrcpy`][copr-link].
+
+[COPR]: https://fedoraproject.org/wiki/Category:Copr
+[copr-link]: https://copr.fedorainfracloud.org/coprs/zeno/scrcpy/
+
+Para Arch Linux, um pacote [AUR] está disponível: [`scrcpy`][aur-link].
+
+[AUR]: https://wiki.archlinux.org/index.php/Arch_User_Repository
+[aur-link]: https://aur.archlinux.org/packages/scrcpy/
+
+Para Gentoo, uma [Ebuild] está disponível: [`scrcpy/`][ebuild-link].
+
+[Ebuild]: https://wiki.gentoo.org/wiki/Ebuild
+[ebuild-link]: https://github.com/maggu2810/maggu2810-overlay/tree/master/app-mobilephone/scrcpy
+
+Você também pode [compilar o app manualmente][BUILD] (não se preocupe, não é tão
+difícil).
+
+
+
+### Windows
+
+Para Windows, por simplicidade, um arquivo pré-compilado com todas as dependências
+(incluindo `adb`) está disponível:
+
+ - [README](README.md#windows)
+
+Também está disponível em [Chocolatey]:
+
+[Chocolatey]: https://chocolatey.org/
+
+```bash
+choco install scrcpy
+choco install adb # se você ainda não o tem
+```
+
+E no [Scoop]:
+
+```bash
+scoop install scrcpy
+scoop install adb # se você ainda não o tem
+```
+
+[Scoop]: https://scoop.sh
+
+Você também pode [compilar o app manualmente][BUILD].
+
+
+### macOS
+
+A aplicação está disponível em [Homebrew]. Apenas instale-a:
+
+[Homebrew]: https://brew.sh/
+
+```bash
+brew install scrcpy
+```
+
+Você precisa do `adb`, acessível pelo seu `PATH`. Se você ainda não o tem:
+
+```bash
+# Homebrew >= 2.6.0
+brew install --cask android-platform-tools
+
+# Homebrew < 2.6.0
+brew cask install android-platform-tools
+```
+
+Você também pode [compilar o app manualmente][BUILD].
+
+
+## Executar
+
+Conecte um dispositivo Android e execute:
+
+```bash
+scrcpy
+```
+
+Também aceita argumentos de linha de comando, listados por:
+
+```bash
+scrcpy --help
+```
+
+## Funcionalidades
+
+### Configuração de captura
+
+#### Reduzir tamanho
+
+Algumas vezes, é útil espelhar um dispositivo Android em uma resolução menor para
+aumentar a performance.
+
+Para limitar ambos (largura e altura) para algum valor (ex: 1024):
+
+```bash
+scrcpy --max-size 1024
+scrcpy -m 1024 # versão curta
+```
+
+A outra dimensão é calculada para que a proporção do dispositivo seja preservada.
+Dessa forma, um dispositivo de 1920x1080 será espelhado em 1024x576.
+
+
+#### Mudar bit-rate
+
+O bit-rate padrão é 8 Mbps. Para mudar o bit-rate do vídeo (ex: para 2 Mbps):
+
+```bash
+scrcpy --bit-rate 2M
+scrcpy -b 2M # versão curta
+```
+
+#### Limitar frame rate
+
+O frame rate de captura pode ser limitado:
+
+```bash
+scrcpy --max-fps 15
+```
+
+Isso é oficialmente suportado desde o Android 10, mas pode funcionar em versões anteriores.
+
+#### Cortar
+
+A tela do dispositivo pode ser cortada para espelhar apenas uma parte da tela.
+
+Isso é útil por exemplo, para espelhar apenas um olho do Oculus Go:
+
+```bash
+scrcpy --crop 1224:1440:0:0 # 1224x1440 no deslocamento (0,0)
+```
+
+Se `--max-size` também for especificado, o redimensionamento é aplicado após o corte.
+
+
+#### Travar orientação do vídeo
+
+
+Para travar a orientação do espelhamento:
+
+```bash
+scrcpy --lock-video-orientation 0 # orientação natural
+scrcpy --lock-video-orientation 1 # 90° sentido anti-horário
+scrcpy --lock-video-orientation 2 # 180°
+scrcpy --lock-video-orientation 3 # 90° sentido horário
+```
+
+Isso afeta a orientação de gravação.
+
+A [janela também pode ser rotacionada](#rotação) independentemente.
+
+
+#### Encoder
+
+Alguns dispositivos têm mais de um encoder, e alguns deles podem causar problemas ou
+travar. É possível selecionar um encoder diferente:
+
+```bash
+scrcpy --encoder OMX.qcom.video.encoder.avc
+```
+
+Para listar os encoders disponíveis, você pode passar um nome de encoder inválido, o
+erro dará os encoders disponíveis:
+
+```bash
+scrcpy --encoder _
+```
+
+### Gravando
+
+É possível gravar a tela enquanto ocorre o espelhamento:
+
+```bash
+scrcpy --record file.mp4
+scrcpy -r file.mkv
+```
+
+Para desativar o espelhamento durante a gravação:
+
+```bash
+scrcpy --no-display --record file.mp4
+scrcpy -Nr file.mkv
+# interrompa a gravação com Ctrl+C
+```
+
+"Frames pulados" são gravados, mesmo que não sejam exibidos em tempo real (por
+motivos de performance). Frames têm seu _horário carimbado_ no dispositivo, então [variação de atraso nos
+pacotes][packet delay variation] não impacta o arquivo gravado.
+
+[packet delay variation]: https://en.wikipedia.org/wiki/Packet_delay_variation
+
+
+### Conexão
+
+#### Sem fio
+
+_Scrcpy_ usa `adb` para se comunicar com o dispositivo, e `adb` pode [conectar-se][connect] a um
+dispositivo via TCP/IP:
+
+1. Conecte o dispositivo no mesmo Wi-Fi do seu computador.
+2. Pegue o endereço IP do seu dispositivo, em Configurações → Sobre o telefone → Status, ou
+ executando este comando:
+
+ ```bash
+ adb shell ip route | awk '{print $9}'
+ ```
+
+3. Ative o adb via TCP/IP no seu dispositivo: `adb tcpip 5555`.
+4. Desconecte seu dispositivo.
+5. Conecte-se ao seu dispositivo: `adb connect DEVICE_IP:5555` _(substitua `DEVICE_IP`)_.
+6. Execute `scrcpy` como de costume.
+
+Pode ser útil diminuir o bit-rate e a resolução:
+
+```bash
+scrcpy --bit-rate 2M --max-size 800
+scrcpy -b2M -m800 # versão curta
+```
+
+[connect]: https://developer.android.com/studio/command-line/adb.html#wireless
+
+
+#### Múltiplos dispositivos
+
+Se vários dispositivos são listados em `adb devices`, você deve especificar o _serial_:
+
+```bash
+scrcpy --serial 0123456789abcdef
+scrcpy -s 0123456789abcdef # versão curta
+```
+
+Se o dispositivo está conectado via TCP/IP:
+
+```bash
+scrcpy --serial 192.168.0.1:5555
+scrcpy -s 192.168.0.1:5555 # versão curta
+```
+
+Você pode iniciar várias instâncias do _scrcpy_ para vários dispositivos.
+
+#### Iniciar automaticamente quando dispositivo é conectado
+
+Você pode usar [AutoAdb]:
+
+```bash
+autoadb scrcpy -s '{}'
+```
+
+[AutoAdb]: https://github.com/rom1v/autoadb
+
+#### Túnel SSH
+
+Para conectar-se a um dispositivo remoto, é possível conectar um cliente `adb` local a
+um servidor `adb` remoto (contanto que eles usem a mesma versão do protocolo
+_adb_):
+
+```bash
+adb kill-server # encerra o servidor adb local em 5037
+ssh -CN -L5037:localhost:5037 -R27183:localhost:27183 your_remote_computer
+# mantenha isso aberto
+```
+
+De outro terminal:
+
+```bash
+scrcpy
+```
+
+Para evitar ativar o encaminhamento de porta remota, você pode forçar uma conexão
+de encaminhamento (note o `-L` em vez de `-R`):
+
+```bash
+adb kill-server # encerra o servidor adb local em 5037
+ssh -CN -L5037:localhost:5037 -L27183:localhost:27183 your_remote_computer
+# mantenha isso aberto
+```
+
+De outro terminal:
+
+```bash
+scrcpy --force-adb-forward
+```
+
+
+Igual a conexões sem fio, pode ser útil reduzir a qualidade:
+
+```
+scrcpy -b2M -m800 --max-fps 15
+```
+
+### Configuração de janela
+
+#### Título
+
+Por padrão, o título da janela é o modelo do dispositivo. Isso pode ser mudado:
+
+```bash
+scrcpy --window-title 'Meu dispositivo'
+```
+
+#### Posição e tamanho
+
+A posição e tamanho iniciais da janela podem ser especificados:
+
+```bash
+scrcpy --window-x 100 --window-y 100 --window-width 800 --window-height 600
+```
+
+#### Sem bordas
+
+Para desativar decorações de janela:
+
+```bash
+scrcpy --window-borderless
+```
+
+#### Sempre no topo
+
+Para manter a janela do scrcpy sempre no topo:
+
+```bash
+scrcpy --always-on-top
+```
+
+#### Tela cheia
+
+A aplicação pode ser iniciada diretamente em tela cheia:
+
+```bash
+scrcpy --fullscreen
+scrcpy -f # versão curta
+```
+
+Tela cheia pode ser alternada dinamicamente com MOD+f.
+
+#### Rotação
+
+A janela pode ser rotacionada:
+
+```bash
+scrcpy --rotation 1
+```
+
+Valores possíveis são:
+ - `0`: sem rotação
+ - `1`: 90 graus sentido anti-horário
+ - `2`: 180 graus
+ - `3`: 90 graus sentido horário
+
+A rotação também pode ser mudada dinamicamente com MOD+←
+_(esquerda)_ e MOD+→ _(direita)_.
+
+Note que _scrcpy_ controla 3 rotações diferentes:
+ - MOD+r requisita ao dispositivo para mudar entre retrato
+ e paisagem (a aplicação em execução pode se recusar, se ela não suporta a
+ orientação requisitada).
+ - [`--lock-video-orientation`](#travar-orientação-do-vídeo) muda a orientação de
+ espelhamento (a orientação do vídeo enviado pelo dispositivo para o
+ computador). Isso afeta a gravação.
+ - `--rotation` (ou MOD+←/MOD+→)
+ rotaciona apenas o conteúdo da janela. Isso afeta apenas a exibição, não a
+ gravação.
+
+
+### Outras opções de espelhamento
+
+#### Apenas leitura
+
+Para desativar controles (tudo que possa interagir com o dispositivo: teclas de entrada,
+eventos de mouse, arrastar e soltar arquivos):
+
+```bash
+scrcpy --no-control
+scrcpy -n
+```
+
+#### Display
+
+Se vários displays estão disponíveis, é possível selecionar o display para
+espelhar:
+
+```bash
+scrcpy --display 1
+```
+
+A lista de IDs dos displays pode ser obtida por:
+
+```
+adb shell dumpsys display # busca "mDisplayId=" na saída
+```
+
+O display secundário pode apenas ser controlado se o dispositivo roda pelo menos Android
+10 (caso contrário é espelhado como apenas leitura).
+
+
+#### Permanecer ativo
+
+Para evitar que o dispositivo seja suspenso após um delay quando o dispositivo é conectado:
+
+```bash
+scrcpy --stay-awake
+scrcpy -w
+```
+
+O estado inicial é restaurado quando o scrcpy é fechado.
+
+
+#### Desligar tela
+
+É possível desligar a tela do dispositivo durante o início do espelhamento com uma
+opção de linha de comando:
+
+```bash
+scrcpy --turn-screen-off
+scrcpy -S
+```
+
+Ou apertando MOD+o a qualquer momento.
+
+Para ligar novamente, pressione MOD+Shift+o.
+
+No Android, o botão de `POWER` sempre liga a tela. Por conveniência, se
+`POWER` é enviado via scrcpy (via clique-direito ou MOD+p), ele
+forçará a desligar a tela após um delay pequeno (numa base de melhor esforço).
+O botão `POWER` físico ainda causará a tela ser ligada.
+
+Também pode ser útil evitar que o dispositivo seja suspenso:
+
+```bash
+scrcpy --turn-screen-off --stay-awake
+scrcpy -Sw
+```
+
+
+#### Renderizar frames expirados
+
+Por padrão, para minimizar a latência, _scrcpy_ sempre renderiza o último frame decodificado
+disponível, e descarta o anterior.
+
+Para forçar a renderização de todos os frames (com o custo de um possível aumento de
+latência), use:
+
+```bash
+scrcpy --render-expired-frames
+```
+
+#### Mostrar toques
+
+Para apresentações, pode ser útil mostrar toques físicos (no dispositivo
+físico).
+
+Android fornece esta funcionalidade nas _Opções do desenvolvedor_.
+
+_Scrcpy_ fornece esta opção de ativar esta funcionalidade no início e restaurar o
+valor inicial no encerramento:
+
+```bash
+scrcpy --show-touches
+scrcpy -t
+```
+
+Note que isto mostra apenas toques _físicos_ (com o dedo no dispositivo).
+
+
+#### Desativar descanso de tela
+
+Por padrão, scrcpy não evita que o descanso de tela rode no computador.
+
+Para desativá-lo:
+
+```bash
+scrcpy --disable-screensaver
+```
+
+
+### Controle de entrada
+
+#### Rotacionar a tela do dispositivo
+
+Pressione MOD+r para mudar entre os modos retrato e
+paisagem.
+
+Note que só será rotacionado se a aplicação em primeiro plano suportar a
+orientação requisitada.
+
+#### Copiar-colar
+
+Sempre que a área de transferência do Android muda, é automaticamente sincronizada com a
+área de transferência do computador.
+
+Qualquer atalho com Ctrl é encaminhado para o dispositivo. Em particular:
+ - Ctrl+c tipicamente copia
+ - Ctrl+x tipicamente recorta
+ - Ctrl+v tipicamente cola (após a sincronização de área de transferência
+ computador-para-dispositivo)
+
+Isso tipicamente funciona como esperado.
+
+O comportamento de fato depende da aplicação ativa, no entanto. Por exemplo,
+_Termux_ envia SIGINT com Ctrl+c, e _K-9 Mail_
+compõe uma nova mensagem.
+
+Para copiar, recortar e colar em tais casos (mas apenas suportado no Android >= 7):
+ - MOD+c injeta `COPY`
+ - MOD+x injeta `CUT`
+ - MOD+v injeta `PASTE` (após a sincronização de área de transferência
+ computador-para-dispositivo)
+
+Em adição, MOD+Shift+v permite injetar o
+texto da área de transferência do computador como uma sequência de eventos de tecla. Isso é útil quando o
+componente não aceita colar texto (por exemplo no _Termux_), mas pode
+quebrar conteúdo não-ASCII.
+
+**ADVERTÊNCIA:** Colar a área de transferência do computador para o dispositivo (tanto via
+Ctrl+v quanto MOD+v) copia o conteúdo
+para a área de transferência do dispositivo. Como consequência, qualquer aplicação Android pode ler
+o seu conteúdo. Você deve evitar colar conteúdo sensível (como senhas) dessa
+forma.
+
+Alguns dispositivos não se comportam como esperado quando a área de transferência é definida
+programaticamente. Uma opção `--legacy-paste` é fornecida para mudar o comportamento
+de Ctrl+v e MOD+v para que eles
+também injetem o texto da área de transferência do computador como uma sequência de eventos de tecla (da mesma
+forma que MOD+Shift+v).
+
+#### Pinçar para dar zoom
+
+Para simular "pinçar para dar zoom": Ctrl+_clicar-e-mover_.
+
+Mais precisamente, segure Ctrl enquanto pressiona o botão de clique-esquerdo. Até que
+o botão de clique-esquerdo seja liberado, todos os movimentos do mouse ampliar e rotacionam o
+conteúdo (se suportado pelo app) relativo ao centro da tela.
+
+Concretamente, scrcpy gera eventos adicionais de toque de um "dedo virtual" em
+uma posição invertida em relação ao centro da tela.
+
+
+#### Preferência de injeção de texto
+
+Existem dois tipos de [eventos][textevents] gerados ao digitar um texto:
+ - _eventos de tecla_, sinalizando que a tecla foi pressionada ou solta;
+ - _eventos de texto_, sinalizando que o texto foi inserido.
+
+Por padrão, letras são injetadas usando eventos de tecla, assim o teclado comporta-se
+como esperado em jogos (normalmente para teclas WASD).
+
+Mas isso pode [causar problemas][prefertext]. Se você encontrar tal problema, você
+pode evitá-lo com:
+
+```bash
+scrcpy --prefer-text
+```
+
+(mas isso vai quebrar o comportamento do teclado em jogos)
+
+[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 padrão, segurar uma tecla gera eventos de tecla repetidos. Isso pode causar
+problemas de performance em alguns jogos, onde esses eventos são inúteis de qualquer forma.
+
+Para evitar o encaminhamento eventos de tecla repetidos:
+
+```bash
+scrcpy --no-key-repeat
+```
+
+
+#### Clique-direito e clique-do-meio
+
+Por padrão, clique-direito dispara BACK (ou POWER) e clique-do-meio dispara
+HOME. Para desabilitar esses atalhos e encaminhar os cliques para o dispositivo:
+
+```bash
+scrcpy --forward-all-clicks
+```
+
+
+### Soltar arquivo
+
+#### Instalar APK
+
+Para instalar um APK, arraste e solte o arquivo APK (com extensão `.apk`) na janela
+_scrcpy_.
+
+Não existe feedback visual, um log é imprimido no console.
+
+
+#### Enviar arquivo para dispositivo
+
+Para enviar um arquivo para `/sdcard/` no dispositivo, arraste e solte um arquivo (não-APK) para a
+janela do _scrcpy_.
+
+Não existe feedback visual, um log é imprimido no console.
+
+O diretório alvo pode ser mudado ao iniciar:
+
+```bash
+scrcpy --push-target /sdcard/foo/bar/
+```
+
+
+### Encaminhamento de áudio
+
+Áudio não é encaminhado pelo _scrcpy_. Use [sndcpy].
+
+Também veja [issue #14].
+
+[sndcpy]: https://github.com/rom1v/sndcpy
+[issue #14]: https://github.com/Genymobile/scrcpy/issues/14
+
+
+## Atalhos
+
+Na lista a seguir, MOD é o modificador de atalho. Por padrão, é
+Alt (esquerdo) ou Super (esquerdo).
+
+Ele pode ser mudado usando `--shortcut-mod`. Possíveis teclas são `lctrl`, `rctrl`,
+`lalt`, `ralt`, `lsuper` e `rsuper`. Por exemplo:
+
+```bash
+# usar RCtrl para atalhos
+scrcpy --shortcut-mod=rctrl
+
+# usar tanto LCtrl+LAlt quanto LSuper para atalhos
+scrcpy --shortcut-mod=lctrl+lalt,lsuper
+```
+
+_[Super] é tipicamente a tecla Windows ou Cmd._
+
+[Super]: https://en.wikipedia.org/wiki/Super_key_(keyboard_button)
+
+ | Ação | Atalho
+ | ------------------------------------------- |:-----------------------------
+ | Mudar modo de tela cheia | MOD+f
+ | Rotacionar display para esquerda | MOD+← _(esquerda)_
+ | Rotacionar display para direita | MOD+→ _(direita)_
+ | Redimensionar janela para 1:1 (pixel-perfect) | MOD+g
+ | Redimensionar janela para remover bordas pretas | MOD+w \| _Clique-duplo¹_
+ | Clicar em `HOME` | MOD+h \| _Clique-do-meio_
+ | Clicar em `BACK` | MOD+b \| _Clique-direito²_
+ | Clicar em `APP_SWITCH` | MOD+s
+ | Clicar em `MENU` (desbloquear tela | MOD+m
+ | Clicar em `VOLUME_UP` | MOD+↑ _(cima)_
+ | Clicar em `VOLUME_DOWN` | MOD+↓ _(baixo)_
+ | Clicar em `POWER` | MOD+p
+ | Ligar | _Clique-direito²_
+ | Desligar tela do dispositivo (continuar espelhando) | MOD+o
+ | Ligar tela do dispositivo | MOD+Shift+o
+ | Rotacionar tela do dispositivo | MOD+r
+ | Expandir painel de notificação | MOD+n
+ | Colapsar painel de notificação | MOD+Shift+n
+ | Copiar para área de transferência³ | MOD+c
+ | Recortar para área de transferência³ | MOD+x
+ | Sincronizar áreas de transferência e colar³ | MOD+v
+ | Injetar texto da área de transferência do computador | MOD+Shift+v
+ | Ativar/desativar contador de FPS (em stdout) | MOD+i
+ | Pinçar para dar zoom | Ctrl+_clicar-e-mover_
+
+_¹Clique-duplo em bordas pretas para removê-las._
+_²Clique-direito liga a tela se ela estiver desligada, pressiona BACK caso contrário._
+_³Apenas em Android >= 7._
+
+Todos os atalhos Ctrl+_tecla_ são encaminhados para o dispositivo, para que eles sejam
+tratados pela aplicação ativa.
+
+
+## Caminhos personalizados
+
+Para usar um binário _adb_ específico, configure seu caminho na variável de ambiente
+`ADB`:
+
+ ADB=/caminho/para/adb scrcpy
+
+Para sobrepor o caminho do arquivo `scrcpy-server`, configure seu caminho em
+`SCRCPY_SERVER_PATH`.
+
+[useful]: https://github.com/Genymobile/scrcpy/issues/278#issuecomment-429330345
+
+
+## Por quê _scrcpy_?
+
+Um colega me desafiou a encontrar um nome tão impronunciável quanto [gnirehtet].
+
+[`strcpy`] copia uma **str**ing; `scrcpy` copia uma **scr**een.
+
+[gnirehtet]: https://github.com/Genymobile/gnirehtet
+[`strcpy`]: http://man7.org/linux/man-pages/man3/strcpy.3.html
+
+
+## Como compilar?
+
+Veja [BUILD].
+
+[BUILD]: BUILD.md
+
+
+## Problemas comuns
+
+Veja o [FAQ](FAQ.md).
+
+
+## Desenvolvedores
+
+Leia a [página dos desenvolvedores][developers page].
+
+[developers page]: DEVELOP.md
+
+
+## Licença
+
+ Copyright (C) 2018 Genymobile
+ Copyright (C) 2018-2021 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.
+
+## Artigos
+
+- [Introducing scrcpy][article-intro]
+- [Scrcpy now works wirelessly][article-tcpip]
+
+[article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/
+[article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/
diff --git a/README.sp.md b/README.sp.md
new file mode 100644
index 00000000..6f76a7be
--- /dev/null
+++ b/README.sp.md
@@ -0,0 +1,743 @@
+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_.
+
+
+
+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
+
+
+
+### 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-2021 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/
diff --git a/README.zh-Hans.md b/README.zh-Hans.md
new file mode 100644
index 00000000..bdd8023c
--- /dev/null
+++ b/README.zh-Hans.md
@@ -0,0 +1,732 @@
+_Only the original [README](README.md) is guaranteed to be up-to-date._
+
+只有原版的[README](README.md)会保持最新。
+
+本文根据[ed130e05]进行翻译。
+
+[ed130e05]: https://github.com/Genymobile/scrcpy/blob/ed130e05d55615d6014d93f15cfcb92ad62b01d8/README.md
+
+# scrcpy (v1.17)
+
+本应用程序可以显示并控制通过 USB (或 [TCP/IP][article-tcpip]) 连接的安卓设备，且不需要任何 _root_ 权限。本程序支持 _GNU/Linux_, _Windows_ 和 _macOS_。
+
+
+
+它专注于：
+
+ - **轻量** (原生，仅显示设备屏幕)
+ - **性能** (30~60fps)
+ - **质量** (分辨率可达 1920×1080 或更高)
+ - **低延迟** ([35~70ms][lowlatency])
+ - **快速启动** (最快 1 秒内即可显示第一帧)
+ - **无侵入性** (不会在设备上遗留任何程序)
+
+[lowlatency]: https://github.com/Genymobile/scrcpy/pull/646
+
+
+## 系统要求
+
+安卓设备最低需要支持 API 21 (Android 5.0)。
+
+确保设备已[开启 adb 调试][enable-adb]。
+
+[enable-adb]: https://developer.android.com/studio/command-line/adb.html#Enabling
+
+在某些设备上，还需要开启[额外的选项][control]以使用鼠标和键盘进行控制。
+
+[control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323
+
+
+## 获取本程序
+
+
+
+### Linux
+
+在 Debian (目前仅支持 _testing_ 和 _sid_ 分支) 和Ubuntu (20.04) 上：
+
+```
+apt install scrcpy
+```
+
+我们也提供 [Snap] 包： [`scrcpy`][snap-link]。
+
+[snap-link]: https://snapstats.org/snaps/scrcpy
+
+[snap]: https://en.wikipedia.org/wiki/Snappy_(package_manager)
+
+对 Fedora 我们提供 [COPR] 包： [`scrcpy`][copr-link]。
+
+[COPR]: https://fedoraproject.org/wiki/Category:Copr
+[copr-link]: https://copr.fedorainfracloud.org/coprs/zeno/scrcpy/
+
+对 Arch Linux 我们提供 [AUR] 包： [`scrcpy`][aur-link]。
+
+[AUR]: https://wiki.archlinux.org/index.php/Arch_User_Repository
+[aur-link]: https://aur.archlinux.org/packages/scrcpy/
+
+对 Gentoo 我们提供 [Ebuild] 包：[`scrcpy/`][ebuild-link]。
+
+[Ebuild]: https://wiki.gentoo.org/wiki/Ebuild
+[ebuild-link]: https://github.com/maggu2810/maggu2810-overlay/tree/master/app-mobilephone/scrcpy
+
+您也可以[自行构建][BUILD] (不必担心，这并不困难)。
+
+
+
+### Windows
+
+在 Windows 上，简便起见，我们提供包含了所有依赖 (包括 `adb`) 的预编译包。
+
+ - [README](README.md#windows)
+
+也可以使用 [Chocolatey]：
+
+[Chocolatey]: https://chocolatey.org/
+
+```bash
+choco install scrcpy
+choco install adb # 如果还没有 adb
+```
+
+或者 [Scoop]:
+
+```bash
+scoop install scrcpy
+scoop install adb # 如果还没有 adb
+```
+
+[Scoop]: https://scoop.sh
+
+您也可以[自行构建][BUILD]。
+
+
+### macOS
+
+本程序已发布到 [Homebrew]。直接安装即可：
+
+[Homebrew]: https://brew.sh/
+
+```bash
+brew install scrcpy
+```
+
+你还需要在 `PATH` 内有 `adb`。如果还没有：
+
+```bash
+# Homebrew >= 2.6.0
+brew install --cask android-platform-tools
+
+# Homebrew < 2.6.0
+brew cask install android-platform-tools
+```
+
+您也可以[自行构建][BUILD]。
+
+
+## 运行
+
+连接安卓设备，然后执行：
+
+```bash
+scrcpy
+```
+
+本程序支持命令行参数，查看参数列表：
+
+```bash
+scrcpy --help
+```
+
+## 功能介绍
+
+### 捕获设置
+
+#### 降低分辨率
+
+有时候，可以通过降低镜像的分辨率来提高性能。
+
+要同时限制宽度和高度到某个值 (例如 1024)：
+
+```bash
+scrcpy --max-size 1024
+scrcpy -m 1024 # 简写
+```
+
+另一边会被按比例缩小以保持设备的显示比例。这样，1920×1080 分辨率的设备会以 1024×576 的分辨率进行镜像。
+
+
+#### 修改码率
+
+默认码率是 8Mbps。要改变视频的码率 (例如改为 2Mbps)：
+
+```bash
+scrcpy --bit-rate 2M
+scrcpy -b 2M # 简写
+```
+
+#### 限制帧率
+
+要限制捕获的帧率：
+
+```bash
+scrcpy --max-fps 15
+```
+
+本功能从 Android 10 开始才被官方支持，但在一些旧版本中也能生效。
+
+#### 画面裁剪
+
+可以对设备屏幕进行裁剪，只镜像屏幕的一部分。
+
+例如可以只镜像 Oculus Go 的一只眼睛。
+
+```bash
+scrcpy --crop 1224:1440:0:0 # 以 (0,0) 为原点的 1224x1440 像素
+```
+
+如果同时指定了 `--max-size`，会先进行裁剪，再进行缩放。
+
+
+#### 锁定屏幕方向
+
+
+要锁定镜像画面的方向：
+
+```bash
+scrcpy --lock-video-orientation 0 # 自然方向
+scrcpy --lock-video-orientation 1 # 逆时针旋转 90°
+scrcpy --lock-video-orientation 2 # 180°
+scrcpy --lock-video-orientation 3 # 顺时针旋转 90°
+```
+
+只影响录制的方向。
+
+[窗口可以独立旋转](#旋转)。
+
+
+#### 编码器
+
+一些设备内置了多种编码器，但是有的编码器会导致问题或崩溃。可以手动选择其它编码器：
+
+```bash
+scrcpy --encoder OMX.qcom.video.encoder.avc
+```
+
+要列出可用的编码器，可以指定一个不存在的编码器名称，错误信息中会包含所有的编码器：
+
+```bash
+scrcpy --encoder _
+```
+
+### 屏幕录制
+
+可以在镜像的同时录制视频：
+
+```bash
+scrcpy --record file.mp4
+scrcpy -r file.mkv
+```
+
+仅录制，不显示镜像：
+
+```bash
+scrcpy --no-display --record file.mp4
+scrcpy -Nr file.mkv
+# 按 Ctrl+C 停止录制
+```
+
+录制时会包含“被跳过的帧”，即使它们由于性能原因没有实时显示。设备会为每一帧打上 _时间戳_ ，所以 [包时延抖动][packet delay variation] 不会影响录制的文件。
+
+[packet delay variation]: https://en.wikipedia.org/wiki/Packet_delay_variation
+
+
+### 连接
+
+#### 无线
+
+_Scrcpy_ 使用 `adb` 与设备通信，并且 `adb` 支持通过 TCP/IP [连接]到设备:
+
+1. 将设备和电脑连接至同一 Wi-Fi。
+2. 打开 设置 → 关于手机 → 状态信息，获取设备的 IP 地址，也可以执行以下的命令：
+ ```bash
+ adb shell ip route | awk '{print $9}'
+ ```
+
+3. 启用设备的网络 adb 功能 `adb tcpip 5555`。
+4. 断开设备的 USB 连接。
+5. 连接到您的设备：`adb connect DEVICE_IP:5555` _(将 `DEVICE_IP` 替换为设备 IP)_.
+6. 正常运行 `scrcpy`。
+
+可能需要降低码率和分辨率：
+
+```bash
+scrcpy --bit-rate 2M --max-size 800
+scrcpy -b2M -m800 # 简写
+```
+
+[连接]: https://developer.android.com/studio/command-line/adb.html#wireless
+
+
+#### 多设备
+
+如果 `adb devices` 列出了多个设备，您必须指定设备的 _序列号_ ：
+
+```bash
+scrcpy --serial 0123456789abcdef
+scrcpy -s 0123456789abcdef # 简写
+```
+
+如果设备通过 TCP/IP 连接：
+
+```bash
+scrcpy --serial 192.168.0.1:5555
+scrcpy -s 192.168.0.1:5555 # 简写
+```
+
+您可以同时启动多个 _scrcpy_ 实例以同时显示多个设备的画面。
+
+#### 在设备连接时自动启动
+
+您可以使用 [AutoAdb]:
+
+```bash
+autoadb scrcpy -s '{}'
+```
+
+[AutoAdb]: https://github.com/rom1v/autoadb
+
+#### SSH 隧道
+
+要远程连接到设备，可以将本地的 adb 客户端连接到远程的 adb 服务端 (需要两端的 _adb_ 协议版本相同)：
+
+```bash
+adb kill-server # 关闭本地 5037 端口上的 adb 服务端
+ssh -CN -L5037:localhost:5037 -R27183:localhost:27183 your_remote_computer
+# 保持该窗口开启
+```
+
+在另一个终端：
+
+```bash
+scrcpy
+```
+
+若要不使用远程端口转发，可以强制使用正向连接 (注意 `-L` 和 `-R` 的区别)：
+
+```bash
+adb kill-server # 关闭本地 5037 端口上的 adb 服务端
+ssh -CN -L5037:localhost:5037 -L27183:localhost:27183 your_remote_computer
+# 保持该窗口开启
+```
+
+在另一个终端:
+
+```bash
+scrcpy --force-adb-forward
+```
+
+
+类似无线网络连接，可能需要降低画面质量：
+
+```
+scrcpy -b2M -m800 --max-fps 15
+```
+
+### 窗口设置
+
+#### 标题
+
+窗口的标题默认为设备型号。可以通过如下命令修改：
+
+```bash
+scrcpy --window-title 'My device'
+```
+
+#### 位置和大小
+
+您可以指定初始的窗口位置和大小：
+
+```bash
+scrcpy --window-x 100 --window-y 100 --window-width 800 --window-height 600
+```
+
+#### 无边框
+
+关闭边框：
+
+```bash
+scrcpy --window-borderless
+```
+
+#### 保持窗口在最前
+
+您可以通过如下命令保持窗口在最前面：
+
+```bash
+scrcpy --always-on-top
+```
+
+#### 全屏
+
+您可以通过如下命令直接全屏启动scrcpy：
+
+```bash
+scrcpy --fullscreen
+scrcpy -f # 简写
+```
+
+全屏状态可以通过 MOD+f 随时切换。
+
+#### 旋转
+
+可以通过以下命令旋转窗口：
+
+```bash
+scrcpy --rotation 1
+```
+
+可选的值有：
+ - `0`: 无旋转
+ - `1`: 逆时针旋转 90°
+ - `2`: 旋转 180°
+ - `3`: 顺时针旋转 90°
+
+也可以使用 MOD+← _(左箭头)_ 和 MOD+→ _(右箭头)_ 随时更改。
+
+需要注意的是， _scrcpy_ 有三个不同的方向：
+ - MOD+r 请求设备在竖屏和横屏之间切换 (如果前台应用程序不支持请求的朝向，可能会拒绝该请求)。
+ - [`--lock-video-orientation`](#锁定屏幕方向) 改变镜像的朝向 (设备传输到电脑的画面的朝向)。这会影响录制。
+ - `--rotation` (或 MOD+←/MOD+→) 只旋转窗口的内容。这只影响显示，不影响录制。
+
+
+### 其他镜像设置
+
+#### 只读
+
+禁用电脑对设备的控制 (如键盘输入、鼠标事件和文件拖放)：
+
+```bash
+scrcpy --no-control
+scrcpy -n
+```
+
+#### 显示屏
+
+如果设备有多个显示屏，可以选择要镜像的显示屏：
+
+```bash
+scrcpy --display 1
+```
+
+可以通过如下命令列出所有显示屏的 id：
+
+```
+adb shell dumpsys display # 在输出中搜索 “mDisplayId=”
+```
+
+控制第二显示屏需要设备运行 Android 10 或更高版本 (否则将在只读状态下镜像)。
+
+
+#### 保持常亮
+
+阻止设备在连接时休眠：
+
+```bash
+scrcpy --stay-awake
+scrcpy -w
+```
+
+程序关闭时会恢复设备原来的设置。
+
+
+#### 关闭设备屏幕
+
+可以通过以下的命令行参数在关闭设备屏幕的状态下进行镜像：
+
+```bash
+scrcpy --turn-screen-off
+scrcpy -S
+```
+
+或者在任何时候按 MOD+o。
+
+要重新打开屏幕，按下 MOD+Shift+o.
+
+在Android上，`电源` 按钮始终能把屏幕打开。为了方便，对于在 _scrcpy_ 中发出的 `电源` 事件 (通过鼠标右键或 MOD+p)，会 (尽最大的努力) 在短暂的延迟后将屏幕关闭。设备上的 `电源` 按钮仍然能打开设备屏幕。
+
+还可以同时阻止设备休眠：
+
+```bash
+scrcpy --turn-screen-off --stay-awake
+scrcpy -Sw
+```
+
+
+#### 渲染过期帧
+
+默认状态下，为了降低延迟， _scrcpy_ 永远渲染解码成功的最近一帧，并跳过前面任意帧。
+
+强制渲染所有帧 (可能导致延迟变高)：
+
+```bash
+scrcpy --render-expired-frames
+```
+
+#### 显示触摸
+
+在演示时，可能会需要显示物理触摸点 (在物理设备上的触摸点)。
+
+Android 在 _开发者选项_ 中提供了这项功能。
+
+_Scrcpy_ 提供一个选项可以在启动时开启这项功能并在退出时恢复初始设置：
+
+```bash
+scrcpy --show-touches
+scrcpy -t
+```
+
+请注意这项功能只能显示 _物理_ 触摸 (用手指在屏幕上的触摸)。
+
+
+#### 关闭屏保
+
+_Scrcpy_ 默认不会阻止电脑上开启的屏幕保护。
+
+关闭屏幕保护：
+
+```bash
+scrcpy --disable-screensaver
+```
+
+
+### 输入控制
+
+#### 旋转设备屏幕
+
+使用 MOD+r 在竖屏和横屏模式之间切换。
+
+需要注意的是，只有在前台应用程序支持所要求的模式时，才会进行切换。
+
+#### 复制粘贴
+
+每次安卓的剪贴板变化时，其内容都会被自动同步到电脑的剪贴板上。
+
+所有的 Ctrl 快捷键都会被转发至设备。其中：
+ - Ctrl+c 通常执行复制
+ - Ctrl+x 通常执行剪切
+ - Ctrl+v 通常执行粘贴 (在电脑到设备的剪贴板同步完成之后)
+
+大多数时候这些按键都会执行以上的功能。
+
+但实际的行为取决于设备上的前台程序。例如，_Termux_ 会在按下 Ctrl+c 时发送 SIGINT，又如 _K-9 Mail_ 会新建一封邮件。
+
+要在这种情况下进行剪切，复制和粘贴 (仅支持 Android >= 7)：
+ - MOD+c 注入 `COPY` (复制)
+ - MOD+x 注入 `CUT` (剪切)
+ - MOD+v 注入 `PASTE` (粘贴) (在电脑到设备的剪贴板同步完成之后)
+
+另外，MOD+Shift+v 会将电脑的剪贴板内容转换为一串按键事件输入到设备。在应用程序不接受粘贴时 (比如 _Termux_)，这项功能可以派上一定的用场。不过这项功能可能会导致非 ASCII 编码的内容出现错误。
+
+**警告：** 将电脑剪贴板的内容粘贴至设备 (无论是通过 Ctrl+v 还是 MOD+v) 都会将内容复制到设备的剪贴板。如此，任何安卓应用程序都能读取到。您应避免将敏感内容 (如密码) 通过这种方式粘贴。
+
+一些设备不支持通过程序设置剪贴板。通过 `--legacy-paste` 选项可以修改 Ctrl+v 和 MOD+v 的工作方式，使它们通过按键事件 (同 MOD+Shift+v) 来注入电脑剪贴板内容。
+
+#### 双指缩放
+
+模拟“双指缩放”：Ctrl+_按住并移动鼠标_。
+
+更准确的说，在按住鼠标左键时按住 Ctrl。直到松开鼠标左键，所有鼠标移动将以屏幕中心为原点，缩放或旋转内容 (如果应用支持)。
+
+实际上，_scrcpy_ 会在以屏幕中心对称的位置上生成由“虚拟手指”发出的额外触摸事件。
+
+
+#### 文字注入偏好
+
+打字的时候，系统会产生两种[事件][textevents]：
+ - _按键事件_ ，代表一个按键被按下或松开。
+ - _文本事件_ ，代表一个字符被输入。
+
+程序默认使用按键事件来输入字母。只有这样，键盘才会在游戏中正常运作 (例如 WASD 键)。
+
+但这也有可能[造成一些问题][prefertext]。如果您遇到了问题，可以通过以下方式避免：
+
+```bash
+scrcpy --prefer-text
+```
+
+(这会导致键盘在游戏中工作不正常)
+
+[textevents]: https://blog.rom1v.com/2018/03/introducing-scrcpy/#handle-text-input
+[prefertext]: https://github.com/Genymobile/scrcpy/issues/650#issuecomment-512945343
+
+
+#### 按键重复
+
+默认状态下，按住一个按键不放会生成多个重复按键事件。在某些游戏中这可能会导致性能问题。
+
+避免转发重复按键事件：
+
+```bash
+scrcpy --no-key-repeat
+```
+
+
+#### 右键和中键
+
+默认状态下，右键会触发返回键 (或电源键)，中键会触发 HOME 键。要禁用这些快捷键并把所有点击转发到设备：
+
+```bash
+scrcpy --forward-all-clicks
+```
+
+
+### 文件拖放
+
+#### 安装APK
+
+将 APK 文件 (文件名以 `.apk` 结尾) 拖放到 _scrcpy_ 窗口来安装。
+
+该操作在屏幕上不会出现任何变化，而会在控制台输出一条日志。
+
+
+#### 将文件推送至设备
+
+要推送文件到设备的 `/sdcard/`，将 (非 APK) 文件拖放至 _scrcpy_ 窗口。
+
+该操作没有可见的响应，只会在控制台输出日志。
+
+在启动时可以修改目标目录：
+
+```bash
+scrcpy --push-target /sdcard/foo/bar/
+```
+
+
+### 音频转发
+
+_Scrcpy_ 不支持音频。请使用 [sndcpy].
+
+另外请阅读 [issue #14]。
+
+[sndcpy]: https://github.com/rom1v/sndcpy
+[issue #14]: https://github.com/Genymobile/scrcpy/issues/14
+
+
+## 快捷键
+
+在以下列表中, MOD 是快捷键的修饰键。
+默认是 (左) Alt 或 (左) Super。
+
+您可以使用 `--shortcut-mod` 来修改。可选的按键有 `lctrl`、`rctrl`、`lalt`、`ralt`、`lsuper` 和 `rsuper`。例如：
+
+```bash
+# 使用右 Ctrl 键
+scrcpy --shortcut-mod=rctrl
+
+# 使用左 Ctrl 键 + 左 Alt 键，或 Super 键
+scrcpy --shortcut-mod=lctrl+lalt,lsuper
+```
+
+_[Super] 键通常是指 Windows 或 Cmd 键。_
+
+[Super]: https://en.wikipedia.org/wiki/Super_key_(keyboard_button)
+
+ | 操作 | 快捷键 |
+ | --------------------------------- | :------------------------------------------- |
+ | 全屏 | MOD+f |
+ | 向左旋转屏幕 | MOD+← _(左箭头)_ |
+ | 向右旋转屏幕 | MOD+→ _(右箭头)_ |
+ | 将窗口大小重置为1:1 (匹配像素) | MOD+g |
+ | 将窗口大小重置为消除黑边 | MOD+w \| _双击¹_ |
+ | 点按 `主屏幕` | MOD+h \| _鼠标中键_ |
+ | 点按 `返回` | MOD+b \| _鼠标右键²_ |
+ | 点按 `切换应用` | MOD+s |
+ | 点按 `菜单` (解锁屏幕) | MOD+m |
+ | 点按 `音量+` | MOD+↑ _(上箭头)_ |
+ | 点按 `音量-` | MOD+↓ _(下箭头)_ |
+ | 点按 `电源` | MOD+p |
+ | 打开屏幕 | _鼠标右键²_ |
+ | 关闭设备屏幕 (但继续在电脑上显示) | MOD+o |
+ | 打开设备屏幕 | MOD+Shift+o |
+ | 旋转设备屏幕 | MOD+r |
+ | 展开通知面板 | MOD+n |
+ | 收起通知面板 | MOD+Shift+n |
+ | 复制到剪贴板³ | MOD+c |
+ | 剪切到剪贴板³ | MOD+x |
+ | 同步剪贴板并粘贴³ | MOD+v |
+ | 注入电脑剪贴板文本 | MOD+Shift+v |
+ | 打开/关闭FPS显示 (在 stdout) | MOD+i |
+ | 捏拉缩放 | Ctrl+_按住并移动鼠标_ |
+
+_¹双击黑边可以去除黑边_
+_²点击鼠标右键将在屏幕熄灭时点亮屏幕，其余情况则视为按下返回键 。_
+_³需要安卓版本 Android >= 7。_
+
+所有的 Ctrl+_按键_ 的快捷键都会被转发到设备，所以会由当前应用程序进行处理。
+
+
+## 自定义路径
+
+要使用指定的 _adb_ 二进制文件，可以设置环境变量 `ADB`：
+
+ ADB=/path/to/adb scrcpy
+
+要覆盖 `scrcpy-server` 的路径，可以设置 `SCRCPY_SERVER_PATH`。
+
+[useful]: https://github.com/Genymobile/scrcpy/issues/278#issuecomment-429330345
+
+
+## 为什么叫 _scrcpy_ ？
+
+一个同事让我找出一个和 [gnirehtet] 一样难以发音的名字。
+
+[`strcpy`] 复制一个 **str**ing； `scrcpy` 复制一个 **scr**een。
+
+[gnirehtet]: https://github.com/Genymobile/gnirehtet
+[`strcpy`]: http://man7.org/linux/man-pages/man3/strcpy.3.html
+
+
+## 如何构建？
+
+请查看[BUILD]。
+
+[BUILD]: BUILD.md
+
+
+## 常见问题
+
+请查看[FAQ](FAQ.md)。
+
+
+## 开发者
+
+请查看[开发者页面]。
+
+[开发者页面]: DEVELOP.md
+
+
+## 许可协议
+
+ Copyright (C) 2018 Genymobile
+ Copyright (C) 2018-2021 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.
+
+## 相关文章
+
+- [Introducing scrcpy][article-intro]
+- [Scrcpy now works wirelessly][article-tcpip]
+
+[article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/
+[article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/
diff --git a/README.zh-Hant.md b/README.zh-Hant.md
new file mode 100644
index 00000000..c0e30254
--- /dev/null
+++ b/README.zh-Hant.md
@@ -0,0 +1,702 @@
+_Only the original [README](README.md) is guaranteed to be up-to-date._
+
+_只有原版的 [README](README.md)是保證最新的。_
+
+
+本文件翻譯時點: [521f2fe](https://github.com/Genymobile/scrcpy/commit/521f2fe994019065e938aa1a54b56b4f10a4ac4a#diff-04c6e90faac2675aa89e2176d2eec7d8)
+
+
+# scrcpy (v1.15)
+
+Scrcpy 可以透過 USB、或是 [TCP/IP][article-tcpip] 來顯示或控制 Android 裝置。且 scrcpy 不需要 _root_ 權限。
+
+Scrcpy 目前支援 _GNU/Linux_、_Windows_ 和 _macOS_。
+
+
+
+特色:
+
+ - **輕量** (只顯示裝置螢幕)
+ - **效能** (30~60fps)
+ - **品質** (1920×1080 或更高)
+ - **低延遲** ([35~70ms][lowlatency])
+ - **快速啟動** (~1 秒就可以顯示第一個畫面)
+ - **非侵入性** (不安裝、留下任何東西在裝置上)
+
+[lowlatency]: https://github.com/Genymobile/scrcpy/pull/646
+
+
+## 需求
+
+Android 裝置必須是 API 21+ (Android 5.0+)。
+
+請確認裝置上的 [adb 偵錯 (通常位於開發者模式內)][enable-adb] 已啟用。
+
+[enable-adb]: https://developer.android.com/studio/command-line/adb.html#Enabling
+
+
+在部分的裝置上，你也必須啟用[特定的額外選項][control]才能使用鍵盤和滑鼠控制。
+
+[control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323
+
+
+## 下載/獲取軟體
+
+
+### Linux
+
+Debian (目前支援 _testing_ 和 _sid_) 和 Ubuntu (20.04):
+
+```
+apt install scrcpy
+```
+
+[Snap] 上也可以下載: [`scrcpy`][snap-link].
+
+[snap-link]: https://snapstats.org/snaps/scrcpy
+
+[snap]: https://en.wikipedia.org/wiki/Snappy_(package_manager)
+
+在 Fedora 上也可以使用 [COPR] 下載: [`scrcpy`][copr-link].
+
+[COPR]: https://fedoraproject.org/wiki/Category:Copr
+[copr-link]: https://copr.fedorainfracloud.org/coprs/zeno/scrcpy/
+
+在 Arch Linux 上也可以使用 [AUR] 下載: [`scrcpy`][aur-link].
+
+[AUR]: https://wiki.archlinux.org/index.php/Arch_User_Repository
+[aur-link]: https://aur.archlinux.org/packages/scrcpy/
+
+在 Gentoo 上也可以使用 [Ebuild] 下載: [`scrcpy/`][ebuild-link].
+
+[Ebuild]: https://wiki.gentoo.org/wiki/Ebuild
+[ebuild-link]: https://github.com/maggu2810/maggu2810-overlay/tree/master/app-mobilephone/scrcpy
+
+你也可以自己[編譯 _Scrcpy_][BUILD]。別擔心，並沒有想像中的難。
+
+
+
+### Windows
+
+為了保持簡單，Windows 用戶可以下載一個包含所有必需軟體 (包含 `adb`) 的壓縮包:
+
+ - [README](README.md#windows)
+
+[Chocolatey] 上也可以下載:
+
+[Chocolatey]: https://chocolatey.org/
+
+```bash
+choco install scrcpy
+choco install adb # 如果你還沒有安裝的話
+```
+
+[Scoop] 上也可以下載:
+
+```bash
+scoop install scrcpy
+scoop install adb # 如果你還沒有安裝的話
+```
+
+[Scoop]: https://scoop.sh
+
+你也可以自己[編譯 _Scrcpy_][BUILD]。
+
+
+### macOS
+
+_Scrcpy_ 可以在 [Homebrew] 上直接安裝:
+
+[Homebrew]: https://brew.sh/
+
+```bash
+brew install scrcpy
+```
+
+由於執行期間需要可以藉由 `PATH` 存取 `adb` 。如果還沒有安裝 `adb` 可以使用下列方式安裝:
+
+```bash
+brew cask install android-platform-tools
+```
+
+你也可以自己[編譯 _Scrcpy_][BUILD]。
+
+
+## 執行
+
+將電腦和你的 Android 裝置連線，然後執行:
+
+```bash
+scrcpy
+```
+
+_Scrcpy_ 可以接受命令列參數。輸入下列指令就可以瀏覽可以使用的命令列參數:
+
+```bash
+scrcpy --help
+```
+
+
+## 功能
+
+> 以下說明中，有關快捷鍵的說明可能會出現 MOD 按鈕。相關說明請參見[快捷鍵]內的說明。
+
+[快捷鍵]: #快捷鍵
+
+### 畫面擷取
+
+#### 縮小尺寸
+
+使用比較低的解析度來投放 Android 裝置在某些情況可以提升效能。
+
+限制寬和高的最大值(例如: 1024):
+
+```bash
+scrcpy --max-size 1024
+scrcpy -m 1024 # 縮短版本
+```
+
+比較小的參數會根據螢幕比例重新計算。
+根據上面的範例，1920x1080 會被縮小成 1024x576。
+
+
+#### 更改 bit-rate
+
+預設的 bit-rate 是 8 Mbps。如果要更改 bit-rate (例如: 2 Mbps):
+
+```bash
+scrcpy --bit-rate 2M
+scrcpy -b 2M # 縮短版本
+```
+
+#### 限制 FPS
+
+限制畫面最高的 FPS:
+
+```bash
+scrcpy --max-fps 15
+```
+
+僅在 Android 10 後正式支援，不過也有可能可以在 Android 10 以前的版本使用。
+
+#### 裁切
+
+裝置的螢幕可以裁切。如此一來，鏡像出來的螢幕就只會是原本的一部份。
+
+假如只要鏡像 Oculus Go 的其中一隻眼睛:
+
+```bash
+scrcpy --crop 1224:1440:0:0 # 位於 (0,0)，大小1224x1440
+```
+
+如果 `--max-size` 也有指定的話，裁切後才會縮放。
+
+
+#### 鎖定影像方向
+
+
+如果要鎖定鏡像影像方向:
+
+```bash
+scrcpy --lock-video-orientation 0 # 原本的方向
+scrcpy --lock-video-orientation 1 # 逆轉 90°
+scrcpy --lock-video-orientation 2 # 180°
+scrcpy --lock-video-orientation 3 # 順轉 90°
+```
+
+這會影響錄影結果的影像方向。
+
+
+### 錄影
+
+鏡像投放螢幕的同時也可以錄影:
+
+```bash
+scrcpy --record file.mp4
+scrcpy -r file.mkv
+```
+
+如果只要錄影，不要投放螢幕鏡像的話:
+
+```bash
+scrcpy --no-display --record file.mp4
+scrcpy -Nr file.mkv
+# 用 Ctrl+C 停止錄影
+```
+
+就算有些幀為了效能而被跳過，它們還是一樣會被錄製。
+
+裝置上的每一幀都有時間戳記，所以 [封包延遲 (Packet Delay Variation, PDV)][packet delay variation] 並不會影響錄影的檔案。
+
+[packet delay variation]: https://en.wikipedia.org/wiki/Packet_delay_variation
+
+
+### 連線
+
+#### 無線
+
+_Scrcpy_ 利用 `adb` 和裝置通訊，而 `adb` 可以[透過 TCP/IP 連結][connect]:
+
+1. 讓電腦和裝置連到同一個 Wi-Fi。
+2. 獲取手機的 IP 位址(設定 → 關於手機 → 狀態).
+3. 啟用裝置上的 `adb over TCP/IP`: `adb tcpip 5555`.
+4. 拔掉裝置上的線。
+5. 透過 TCP/IP 連接裝置: `adb connect DEVICE_IP:5555` _(把 `DEVICE_IP` 換成裝置的IP位址)_.
+6. 和平常一樣執行 `scrcpy`。
+
+如果效能太差，可以降低 bit-rate 和解析度:
+
+```bash
+scrcpy --bit-rate 2M --max-size 800
+scrcpy -b2M -m800 # 縮短版本
+```
+
+[connect]: https://developer.android.com/studio/command-line/adb.html#wireless
+
+
+#### 多裝置
+
+如果 `adb devices` 內有多個裝置，則必須附上 _serial_:
+
+```bash
+scrcpy --serial 0123456789abcdef
+scrcpy -s 0123456789abcdef # 縮短版本
+```
+
+如果裝置是透過 TCP/IP 連線:
+
+```bash
+scrcpy --serial 192.168.0.1:5555
+scrcpy -s 192.168.0.1:5555 # 縮短版本
+```
+
+你可以啟用復數個對應不同裝置的 _scrcpy_。
+
+#### 裝置連結後自動啟動
+
+你可以使用 [AutoAdb]:
+
+```bash
+autoadb scrcpy -s '{}'
+```
+
+[AutoAdb]: https://github.com/rom1v/autoadb
+
+#### SSH tunnel
+
+本地的 `adb` 可以連接到遠端的 `adb` 伺服器(假設兩者使用相同版本的 _adb_ 通訊協定)，以連接到遠端裝置:
+
+```bash
+adb kill-server # 停止在 Port 5037 的本地 adb 伺服
+ssh -CN -L5037:localhost:5037 -R27183:localhost:27183 your_remote_computer
+# 保持開啟
+```
+
+從另外一個終端機:
+
+```bash
+scrcpy
+```
+
+如果要避免啟用 remote port forwarding，你可以強制它使用 forward connection (注意 `-L` 和 `-R` 的差別):
+
+```bash
+adb kill-server # 停止在 Port 5037 的本地 adb 伺服
+ssh -CN -L5037:localhost:5037 -L27183:localhost:27183 your_remote_computer
+# 保持開啟
+```
+
+從另外一個終端機:
+
+```bash
+scrcpy --force-adb-forward
+```
+
+
+和無線連接一樣，有時候降低品質會比較好:
+
+```
+scrcpy -b2M -m800 --max-fps 15
+```
+
+### 視窗調整
+
+#### 標題
+
+預設標題是裝置的型號，不過可以透過以下方式修改:
+
+```bash
+scrcpy --window-title 'My device'
+```
+
+#### 位置 & 大小
+
+初始的視窗位置和大小也可以指定:
+
+```bash
+scrcpy --window-x 100 --window-y 100 --window-width 800 --window-height 600
+```
+
+#### 無邊框
+
+如果要停用視窗裝飾:
+
+```bash
+scrcpy --window-borderless
+```
+
+#### 保持最上層
+
+如果要保持 `scrcpy` 的視窗在最上層:
+
+```bash
+scrcpy --always-on-top
+```
+
+#### 全螢幕
+
+這個軟體可以直接在全螢幕模式下起動:
+
+```bash
+scrcpy --fullscreen
+scrcpy -f # 縮短版本
+```
+
+全螢幕可以使用 MOD+f 開關。
+
+#### 旋轉
+
+視窗可以旋轉:
+
+```bash
+scrcpy --rotation 1
+```
+
+可用的數值:
+ - `0`: 不旋轉
+ - `1`: 90 度**逆**轉
+ - `2`: 180 度
+ - `3`: 90 度**順**轉
+
+旋轉方向也可以使用 MOD+← _(左方向鍵)_ 和 MOD+→ _(右方向鍵)_ 調整。
+
+_scrcpy_ 有 3 種不同的旋轉:
+ - MOD+r 要求裝置在垂直、水平之間旋轉 (目前運行中的 App 有可能會因為不支援而拒絕)。
+ - `--lock-video-orientation` 修改鏡像的方向 (裝置傳給電腦的影像)。這會影響錄影結果的影像方向。
+ - `--rotation` (或是 MOD+← / MOD+→) 只旋轉視窗的內容。這只會影響鏡像結果，不會影響錄影結果。
+
+
+### 其他鏡像選項
+
+#### 唯讀
+
+停用所有控制，包含鍵盤輸入、滑鼠事件、拖放檔案:
+
+```bash
+scrcpy --no-control
+scrcpy -n
+```
+
+#### 顯示螢幕
+
+如果裝置有複數個螢幕，可以指定要鏡像哪個螢幕:
+
+```bash
+scrcpy --display 1
+```
+
+可以透過下列指令獲取螢幕 ID:
+
+```
+adb shell dumpsys display # 找輸出結果中的 "mDisplayId="
+```
+
+第二螢幕只有在 Android 10+ 時可以控制。如果不是 Android 10+，螢幕就會在唯讀狀態下投放。
+
+
+#### 保持清醒
+
+如果要避免裝置在連接狀態下進入睡眠:
+
+```bash
+scrcpy --stay-awake
+scrcpy -w
+```
+
+_scrcpy_ 關閉後就會回復成原本的設定。
+
+
+#### 關閉螢幕
+
+鏡像開始時，可以要求裝置關閉螢幕:
+
+```bash
+scrcpy --turn-screen-off
+scrcpy -S
+```
+
+或是在任何時候輸入 MOD+o。
+
+如果要開啟螢幕，輸入 MOD+Shift+o。
+
+在 Android 上，`POWER` 按鈕總是開啟螢幕。
+
+為了方便，如果 `POWER` 是透過 scrcpy 轉送 (右鍵 或 MOD+p)的話，螢幕將會在短暫的延遲後關閉。
+
+實際在手機上的 `POWER` 還是會開啟螢幕。
+
+防止裝置進入睡眠狀態:
+
+```bash
+scrcpy --turn-screen-off --stay-awake
+scrcpy -Sw
+```
+
+
+#### 顯示過期的幀
+
+為了降低延遲， _scrcpy_ 預設只會顯示最後解碼的幀，並且拋棄所有在這之前的幀。
+
+如果要強制顯示所有的幀 (有可能會拉高延遲)，輸入:
+
+```bash
+scrcpy --render-expired-frames
+```
+
+#### 顯示觸控點
+
+對於要報告的人來說，顯示裝置上的實際觸控點有時候是有幫助的。
+
+Android 在_開發者選項_中有提供這個功能。
+
+_Scrcpy_ 可以在啟動時啟用這個功能，並且在停止後恢復成原本的設定:
+
+```bash
+scrcpy --show-touches
+scrcpy -t
+```
+
+這個選項只會顯示**實際觸碰在裝置上的觸碰點**。
+
+
+### 輸入控制
+
+
+#### 旋轉裝置螢幕
+
+輸入 MOD+r 以在垂直、水平之間切換。
+
+如果使用中的程式不支援，則不會切換。
+
+
+#### 複製/貼上
+
+如果 Android 剪貼簿上的內容有任何更動，電腦的剪貼簿也會一起更動。
+
+任何與 Ctrl 相關的快捷鍵事件都會轉送到裝置上。特別來說:
+ - Ctrl+c 通常是複製
+ - Ctrl+x 通常是剪下
+ - Ctrl+v 通常是貼上 (在電腦的剪貼簿與裝置上的剪貼簿同步之後)
+
+這些跟你通常預期的行為一樣。
+
+但是，實際上的行為是根據目前運行中的應用程式而定。
+
+舉例來說， _Termux_ 在收到 Ctrl+c 後，會傳送 SIGINT；而 _K-9 Mail_ 則是建立新訊息。
+
+如果在這情況下，要剪下、複製或貼上 (只有在Android 7+時才支援):
+ - MOD+c 注入 `複製`
+ - MOD+x 注入 `剪下`
+ - MOD+v 注入 `貼上` (在電腦的剪貼簿與裝置上的剪貼簿同步之後)
+
+另外，MOD+Shift+v 則是以一連串的按鍵事件貼上電腦剪貼簿中的內容。當元件不允許文字貼上 (例如 _Termux_) 時，這就很有用。不過，這在非 ASCII 內容上就無法使用。
+
+**警告:** 貼上電腦的剪貼簿內容 (無論是從 Ctrl+v 或 MOD+v) 時，會複製剪貼簿中的內容至裝置的剪貼簿上。這會讓所有 Android 程式讀取剪貼簿的內容。請避免貼上任何敏感內容 (像是密碼)。
+
+
+#### 文字輸入偏好
+
+輸入文字時，有兩種[事件][textevents]會被觸發:
+ - _鍵盤事件 (key events)_，代表有一個按鍵被按下或放開
+ - _文字事件 (text events)_，代表有一個文字被輸入
+
+預設上，文字是被以鍵盤事件 (key events) 輸入的，所以鍵盤和遊戲內所預期的一樣 (通常是指 WASD)。
+
+但是這可能造成[一些問題][prefertext]。如果在這輸入這方面遇到了問題，你可以試試:
+
+```bash
+scrcpy --prefer-text
+```
+
+(不過遊戲內鍵盤就會不可用)
+
+[textevents]: https://blog.rom1v.com/2018/03/introducing-scrcpy/#handle-text-input
+[prefertext]: https://github.com/Genymobile/scrcpy/issues/650#issuecomment-512945343
+
+
+#### 重複輸入
+
+通常來說，長時間按住一個按鍵會重複觸發按鍵事件。這會在一些遊戲中造成效能問題，而且這個重複的按鍵事件是沒有意義的。
+
+如果不要轉送這些重複的按鍵事件:
+
+```bash
+scrcpy --no-key-repeat
+```
+
+
+### 檔案
+
+#### 安裝 APK
+
+如果要安裝 APK ，拖放一個 APK 檔案 (以 `.apk` 為副檔名) 到 _scrcpy_ 的視窗上。
+
+視窗上不會有任何反饋；結果會顯示在命令列中。
+
+
+#### 推送檔案至裝置
+
+如果要推送檔案到裝置上的 `/sdcard/` ，拖放一個非 APK 檔案 (**不**以 `.apk` 為副檔名) 到 _scrcpy_ 的視窗上。
+
+視窗上不會有任何反饋；結果會顯示在命令列中。
+
+推送檔案的目標路徑可以在啟動時指定:
+
+```bash
+scrcpy --push-target /sdcard/foo/bar/
+```
+
+
+### 音訊轉送
+
+_scrcpy_ **不**轉送音訊。請使用 [sndcpy]。另外，參見 [issue #14]。
+
+[sndcpy]: https://github.com/rom1v/sndcpy
+[issue #14]: https://github.com/Genymobile/scrcpy/issues/14
+
+
+## 快捷鍵
+
+在以下的清單中，MOD 是快捷鍵的特殊按鍵。通常來說，這個按鍵是 (左) Alt 或是 (左) Super。
+
+這個是可以使用 `--shortcut-mod` 更改的。可以用的選項有:
+- `lctrl`: 左邊的 Ctrl
+- `rctrl`: 右邊的 Ctrl
+- `lalt`: 左邊的 Alt
+- `ralt`: 右邊的 Alt
+- `lsuper`: 左邊的 Super
+- `rsuper`: 右邊的 Super
+
+```bash
+# 以 右邊的 Ctrl 為快捷鍵特殊按鍵
+scrcpy --shortcut-mod=rctrl
+
+# 以 左邊的 Ctrl 和左邊的 Alt 或是 左邊的 Super 為快捷鍵特殊按鍵
+scrcpy --shortcut-mod=lctrl+lalt,lsuper
+```
+
+_[Super] 通常是 Windows 或 Cmd 鍵。_
+
+[Super]: https://en.wikipedia.org/wiki/Super_key_(keyboard_button)
+
+ | Action | Shortcut
+ | ------------------------------------------------- |:-----------------------------
+ | 切換至全螢幕 | MOD+f
+ | 左旋顯示螢幕 | MOD+← _(左)_
+ | 右旋顯示螢幕 | MOD+→ _(右)_
+ | 縮放視窗成 1:1 (pixel-perfect) | MOD+g
+ | 縮放視窗到沒有黑邊框為止 | MOD+w \| _雙擊¹_
+ | 按下 `首頁` 鍵 | MOD+h \| _中鍵_
+ | 按下 `返回` 鍵 | MOD+b \| _右鍵²_
+ | 按下 `切換 APP` 鍵 | MOD+s
+ | 按下 `選單` 鍵 (或解鎖螢幕) | MOD+m
+ | 按下 `音量+` 鍵 | MOD+↑ _(上)_
+ | 按下 `音量-` 鍵 | MOD+↓ _(下)_
+ | 按下 `電源` 鍵 | MOD+p
+ | 開啟 | _右鍵²_
+ | 關閉裝置螢幕(持續鏡像) | MOD+o
+ | 開啟裝置螢幕 | MOD+Shift+o
+ | 旋轉裝置螢幕 | MOD+r
+ | 開啟通知列 | MOD+n
+ | 關閉通知列 | MOD+Shift+n
+ | 複製至剪貼簿³ | MOD+c
+ | 剪下至剪貼簿³ | MOD+x
+ | 同步剪貼簿並貼上³ | MOD+v
+ | 複製電腦剪貼簿中的文字至裝置並貼上 | MOD+Shift+v
+ | 啟用/停用 FPS 計數器(顯示於 stdout - 通常是命令列) | MOD+i
+
+_¹在黑邊框上雙擊以移除它們。_
+_²右鍵會返回。如果螢幕是關閉狀態，則會打開螢幕。_
+_³只支援 Android 7+。_
+
+所有 Ctrl+_按鍵_ 快捷鍵都會傳送到裝置上，所以它們是由目前運作的應用程式處理的。
+
+
+## 自訂路徑
+
+如果要使用特定的 _adb_ ，將它設定到環境變數中的 `ADB`:
+
+ ADB=/path/to/adb scrcpy
+
+如果要覆寫 `scrcpy-server` 檔案的路徑，則將路徑設定到環境變數中的 `SCRCPY_SERVER_PATH`。
+
+[相關連結][useful]
+
+[useful]: https://github.com/Genymobile/scrcpy/issues/278#issuecomment-429330345
+
+
+## 為何叫 _scrcpy_ ？
+
+有一個同事要我找一個跟 [gnirehtet] 一樣難念的名字。
+
+[`strcpy`] 複製一個字串 (**str**ing)；`scrcpy` 複製一個螢幕 (**scr**een)。
+
+[gnirehtet]: https://github.com/Genymobile/gnirehtet
+[`strcpy`]: http://man7.org/linux/man-pages/man3/strcpy.3.html
+
+
+## 如何編譯？
+
+請看[這份文件 (英文)][BUILD]。
+
+[BUILD]: BUILD.md
+
+
+## 常見問題
+
+請看[這份文件 (英文)][FAQ]。
+
+[FAQ]: FAQ.md
+
+
+## 開發者文件
+
+請看[這個頁面 (英文)][developers page].
+
+[developers page]: DEVELOP.md
+
+
+## Licence
+
+ Copyright (C) 2018 Genymobile
+ Copyright (C) 2018-2021 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.
+
+## 相關文章
+
+- [Scrcpy 簡介 (英文)][article-intro]
+- [Scrcpy 可以無線連線了 (英文)][article-tcpip]
+
+[article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/
+[article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/
diff --git a/app/meson.build b/app/meson.build
index 3bcb9bc1..0663c641 100644
--- a/app/meson.build
+++ b/app/meson.build
@@ -1,16 +1,17 @@
src = [
'src/main.c',
+ 'src/adb.c',
'src/cli.c',
- 'src/command.c',
+ 'src/compat.c',
'src/control_msg.c',
'src/controller.c',
'src/decoder.c',
- 'src/device.c',
'src/device_msg.c',
'src/event_converter.c',
'src/file_handler.c',
'src/fps_counter.c',
'src/input_manager.c',
+ 'src/opengl.c',
'src/receiver.c',
'src/recorder.c',
'src/scrcpy.c',
@@ -19,10 +20,30 @@ src = [
'src/stream.c',
'src/tiny_xpm.c',
'src/video_buffer.c',
+ 'src/util/log.c',
'src/util/net.c',
- 'src/util/str_util.c'
+ 'src/util/process.c',
+ 'src/util/str_util.c',
+ 'src/util/thread.c',
]
+if host_machine.system() == 'windows'
+ src += [ 'src/sys/win/process.c' ]
+else
+ src += [ 'src/sys/unix/process.c' ]
+endif
+
+v4l2_support = host_machine.system() == 'linux'
+if v4l2_support
+ src += [ 'src/v4l2_sink.c' ]
+endif
+
+check_functions = [
+ 'strdup'
+]
+
+cc = meson.get_compiler('c')
+
if not get_option('crossbuild_windows')
# native build
@@ -33,11 +54,13 @@ if not get_option('crossbuild_windows')
dependency('sdl2'),
]
+ if v4l2_support
+ dependencies += dependency('libavdevice')
+ endif
+
else
# cross-compile mingw32 build (from Linux to Windows)
- cc = meson.get_compiler('c')
-
prebuilt_sdl2 = meson.get_cross_property('prebuilt_sdl2')
sdl2_bin_dir = meson.current_source_dir() + '/../prebuilt-deps/' + prebuilt_sdl2 + '/bin'
sdl2_lib_dir = meson.current_source_dir() + '/../prebuilt-deps/' + prebuilt_sdl2 + '/lib'
@@ -72,21 +95,18 @@ else
endif
-cc = meson.get_compiler('c')
-
if host_machine.system() == 'windows'
- src += [ 'src/sys/win/command.c' ]
- src += [ 'src/sys/win/net.c' ]
dependencies += cc.find_library('ws2_32')
-else
- src += [ 'src/sys/unix/command.c' ]
- src += [ 'src/sys/unix/net.c' ]
endif
conf = configuration_data()
-# expose the build type
-conf.set('NDEBUG', get_option('buildtype') != 'debug')
+foreach f : check_functions
+ if cc.has_function(f)
+ define = 'HAVE_' + f.underscorify().to_upper()
+ conf.set(define, true)
+ endif
+endforeach
# the version, updated on release
conf.set_quoted('SCRCPY_VERSION', meson.project_version())
@@ -98,43 +118,33 @@ conf.set_quoted('PREFIX', get_option('prefix'))
# directory as the executable)
conf.set('PORTABLE', get_option('portable'))
-# the default client TCP port for the "adb reverse" tunnel
+# the default client TCP port range for the "adb reverse" tunnel
# overridden by option --port
-conf.set('DEFAULT_LOCAL_PORT', '27183')
-
-# the default max video size for both dimensions, in pixels
-# overridden by option --max-size
-conf.set('DEFAULT_MAX_SIZE', '0') # 0: unlimited
+conf.set('DEFAULT_LOCAL_PORT_RANGE_FIRST', '27183')
+conf.set('DEFAULT_LOCAL_PORT_RANGE_LAST', '27199')
# the default video bitrate, in bits/second
# overridden by option --bit-rate
conf.set('DEFAULT_BIT_RATE', '8000000') # 8Mbps
-# enable High DPI support
-conf.set('HIDPI_SUPPORT', get_option('hidpi_support'))
-
-# disable console on Windows
-conf.set('WINDOWS_NOCONSOLE', get_option('windows_noconsole'))
-
# run a server debugger and wait for a client to be attached
conf.set('SERVER_DEBUGGER', get_option('server_debugger'))
+# select the debugger method ('old' for Android < 9, 'new' for Android >= 9)
+conf.set('SERVER_DEBUGGER_METHOD_NEW', get_option('server_debugger_method') == 'new')
+
+# enable V4L2 support (linux only)
+conf.set('HAVE_V4L2', v4l2_support)
+
configure_file(configuration: conf, output: 'config.h')
src_dir = include_directories('src')
-if get_option('windows_noconsole')
- link_args = [ '-Wl,--subsystem,windows' ]
-else
- link_args = []
-endif
-
executable('scrcpy', src,
dependencies: dependencies,
include_directories: src_dir,
install: true,
- c_args: [],
- link_args: link_args)
+ c_args: [])
install_man('scrcpy.1')
@@ -155,12 +165,12 @@ if get_option('buildtype') == 'debug'
'src/cli.c',
'src/util/str_util.c',
]],
- ['test_control_event_serialize', [
+ ['test_control_msg_serialize', [
'tests/test_control_msg_serialize.c',
'src/control_msg.c',
'src/util/str_util.c',
]],
- ['test_device_event_deserialize', [
+ ['test_device_msg_deserialize', [
'tests/test_device_msg_deserialize.c',
'src/device_msg.c',
]],
@@ -177,7 +187,7 @@ if get_option('buildtype') == 'debug'
exe = executable(t[0], t[1],
include_directories: src_dir,
dependencies: dependencies,
- c_args: ['-DSDL_MAIN_HANDLED'])
+ c_args: ['-DSDL_MAIN_HANDLED', '-DSC_TEST'])
test(t[0], exe)
endforeach
endif
diff --git a/app/scrcpy.1 b/app/scrcpy.1
index 9560df1c..62dc9677 100644
--- a/app/scrcpy.1
+++ b/app/scrcpy.1
@@ -25,6 +25,16 @@ Encode the video at the given bit\-rate, expressed in bits/s. Unit suffixes are
Default is 8000000.
+.TP
+.BI "\-\-codec\-options " key[:type]=value[,...]
+Set a list of comma-separated key:type=value options for the device encoder.
+
+The possible values for 'type' are 'int' (default), 'long', 'float' and 'string'.
+
+The list of possible codec options is available in the Android documentation
+.UR https://d.android.com/reference/android/media/MediaFormat
+.UE .
+
.TP
.BI "\-\-crop " width\fR:\fIheight\fR:\fIx\fR:\fIy
Crop the device screen on the server.
@@ -33,6 +43,31 @@ The values are expressed in the device natural orientation (typically, portrait
.B \-\-max\-size
value is computed on the cropped size.
+.TP
+.BI "\-\-disable-screensaver"
+Disable screensaver while scrcpy is running.
+
+.TP
+.BI "\-\-display " id
+Specify the display id to mirror.
+
+The list of possible display ids can be listed by "adb shell dumpsys display"
+(search "mDisplayId=" in the output).
+
+Default is 0.
+
+.TP
+.BI "\-\-encoder " name
+Use a specific MediaCodec encoder (must be a H.264 encoder).
+
+.TP
+.B \-\-force\-adb\-forward
+Do not attempt to use "adb reverse" to connect to the device.
+
+.TP
+.B \-\-forward\-all\-clicks
+By default, right-click triggers BACK (or POWER on) and middle-click triggers HOME. This option disables these shortcuts and forward the clicks to the device instead.
+
.TP
.B \-f, \-\-fullscreen
Start in fullscreen.
@@ -41,9 +76,23 @@ Start in fullscreen.
.B \-h, \-\-help
Print this help.
+.TP
+.B \-\-legacy\-paste
+Inject computer clipboard text as a sequence of key events on Ctrl+v (like MOD+Shift+v).
+
+This is a workaround for some devices not behaving as expected when setting the device clipboard programmatically.
+
+.TP
+.BI "\-\-lock\-video\-orientation " [value]
+Lock video orientation to \fIvalue\fR. Possible values are "unlocked", "initial" (locked to the initial orientation), 0, 1, 2 and 3. Natural device orientation is 0, and each increment adds a 90 degrees otation counterclockwise.
+
+Default is "unlocked".
+
+Passing the option without argument is equivalent to passing "initial".
+
.TP
.BI "\-\-max\-fps " value
-Limit the framerate of screen capture (only supported on devices with Android >= 10).
+Limit the framerate of screen capture (officially supported since Android 10, but may work on earlier versions).
.TP
.BI "\-m, \-\-max\-size " value
@@ -60,10 +109,18 @@ Disable device control (mirror the device in read\-only).
Do not display device (only when screen recording is enabled).
.TP
-.BI "\-p, \-\-port " port
-Set the TCP port the client listens on.
+.B \-\-no\-key\-repeat
+Do not forward repeated key events when a key is held down.
-Default is 27183.
+.TP
+.B \-\-no\-mipmaps
+If the renderer is OpenGL 3.0+ or OpenGL ES 2.0+, then mipmaps are automatically generated to improve downscaling quality. This option disables the generation of mipmaps.
+
+.TP
+.BI "\-p, \-\-port " port[:port]
+Set the TCP port (range) used by the client to listen.
+
+Default is 27183:27199.
.TP
.B \-\-prefer\-text
@@ -76,7 +133,7 @@ but breaks the expected behavior of alpha keys in games (typically WASD).
.BI "\-\-push\-target " path
Set the target directory for pushing files to the device by drag & drop. It is passed as\-is to "adb push".
-Default is "/sdcard/".
+Default is "/sdcard/Download/".
.TP
.BI "\-r, \-\-record " file
@@ -92,27 +149,62 @@ option if set, or by the file extension (.mp4 or .mkv).
Force recording format (either mp4 or mkv).
.TP
-.B \-\-render\-expired\-frames
-By default, to minimize latency, scrcpy always renders the last available decoded frame, and drops any previous ones. This flag forces to render all frames, at a cost of a possible increased latency.
+.BI "\-\-render\-driver " name
+Request SDL to use the given render driver (this is just a hint).
+
+Supported names are currently "direct3d", "opengl", "opengles2", "opengles", "metal" and "software".
+
+.UR https://wiki.libsdl.org/SDL_HINT_RENDER_DRIVER
+.UE
+
+.TP
+.BI "\-\-rotation " value
+Set the initial display rotation. Possibles values are 0, 1, 2 and 3. Each increment adds a 90 degrees rotation counterclockwise.
.TP
.BI "\-s, \-\-serial " number
The device serial number. Mandatory only if several devices are connected to adb.
+.TP
+.BI "\-\-shortcut\-mod " key[+...]][,...]
+Specify the modifiers to use for scrcpy shortcuts. Possible keys are "lctrl", "rctrl", "lalt", "ralt", "lsuper" and "rsuper".
+
+A shortcut can consist in several keys, separated by '+'. Several shortcuts can be specified, separated by ','.
+
+For example, to use either LCtrl+LAlt or LSuper for scrcpy shortcuts, pass "lctrl+lalt,lsuper".
+
+Default is "lalt,lsuper" (left-Alt or left-Super).
+
.TP
.B \-S, \-\-turn\-screen\-off
Turn the device screen off immediately.
.TP
.B \-t, \-\-show\-touches
-Enable "show touches" on start, disable on quit.
+Enable "show touches" on start, restore the initial value on exit.
It only shows physical touches (not clicks from scrcpy).
+.TP
+.BI "\-\-v4l2-sink " /dev/videoN
+Output to v4l2loopback device.
+
+It requires to lock the video orientation (see --lock-video-orientation).
+
+.TP
+.BI "\-V, \-\-verbosity " value
+Set the log level ("verbose", "debug", "info", "warn" or "error").
+
+Default is "info" for release builds, "debug" for debug builds.
+
.TP
.B \-v, \-\-version
Print the version of scrcpy.
+.TP
+.B \-w, \-\-stay-awake
+Keep the device on while scrcpy is running, when the device is plugged in.
+
.TP
.B \-\-window\-borderless
Disable window decorations (display borderless window).
@@ -125,107 +217,130 @@ Set a custom window title.
.BI "\-\-window\-x " value
Set the initial window horizontal position.
-Default is -1 (automatic).\n
+Default is "auto".
.TP
.BI "\-\-window\-y " value
Set the initial window vertical position.
-Default is -1 (automatic).\n
+Default is "auto".
.TP
.BI "\-\-window\-width " value
Set the initial window width.
-Default is 0 (automatic).\n
+Default is 0 (automatic).
.TP
.BI "\-\-window\-height " value
Set the initial window height.
-Default is 0 (automatic).\n
+Default is 0 (automatic).
.SH SHORTCUTS
-.TP
-.B Ctrl+f
-switch fullscreen mode
+In the following list, MOD is the shortcut modifier. By default, it's (left)
+Alt or (left) Super, but it can be configured by \-\-shortcut-mod (see above).
.TP
-.B Ctrl+g
-resize window to 1:1 (pixel\-perfect)
+.B MOD+f
+Switch fullscreen mode
.TP
-.B Ctrl+x, Double\-click on black borders
-resize window to remove black borders
+.B MOD+Left
+Rotate display left
.TP
-.B Ctrl+h, Home, Middle\-click
+.B MOD+Right
+Rotate display right
+
+.TP
+.B MOD+g
+Resize window to 1:1 (pixel\-perfect)
+
+.TP
+.B MOD+w, Double\-click on black borders
+Resize window to remove black borders
+
+.TP
+.B MOD+h, Home, Middle\-click
Click on HOME
.TP
-.B Ctrl+b, Ctrl+Backspace, Right\-click (when screen is on)
+.B MOD+b, MOD+Backspace, Right\-click (when screen is on)
Click on BACK
.TP
-.B Ctrl+s
+.B MOD+s
Click on APP_SWITCH
.TP
-.B Ctrl+m
+.B MOD+m
Click on MENU
.TP
-.B Ctrl+Up
+.B MOD+Up
Click on VOLUME_UP
.TP
-.B Ctrl+Down
+.B MOD+Down
Click on VOLUME_DOWN
.TP
-.B Ctrl+p
+.B MOD+p
Click on POWER (turn screen on/off)
.TP
.B Right\-click (when screen is off)
-turn screen on
+Turn screen on
.TP
-.B Ctrl+o
-turn device screen off (keep mirroring)
+.B MOD+o
+Turn device screen off (keep mirroring)
.TP
-.B Ctrl+r
-rotate device screen
+.B MOD+Shift+o
+Turn device screen on
.TP
-.B Ctrl+n
-expand notification panel
+.B MOD+r
+Rotate device screen
.TP
-.B Ctrl+Shift+n
-collapse notification panel
+.B MOD+n
+Expand notification panel
.TP
-.B Ctrl+c
-copy device clipboard to computer
+.B MOD+Shift+n
+Collapse notification panel
.TP
-.B Ctrl+v
-paste computer clipboard to device
+.B Mod+c
+Copy to clipboard (inject COPY keycode, Android >= 7 only)
.TP
-.B Ctrl+Shift+v
-copy computer clipboard to device
+.B Mod+x
+Cut to clipboard (inject CUT keycode, Android >= 7 only)
.TP
-.B Ctrl+i
-enable/disable FPS counter (print frames/second in logs)
+.B MOD+v
+Copy computer clipboard to device, then paste (inject PASTE keycode, Android >= 7 only)
+
+.TP
+.B MOD+Shift+v
+Inject computer clipboard text as a sequence of key events
+
+.TP
+.B MOD+i
+Enable/disable FPS counter (print frames/second in logs)
+
+.TP
+.B Ctrl+click-and-move
+Pinch-to-zoom from the center of the screen
.TP
.B Drag & drop APK file
-install APK from computer
+Install APK from computer
.SH Environment variables
diff --git a/app/src/command.c b/app/src/adb.c
similarity index 73%
rename from app/src/command.c
rename to app/src/adb.c
index 63afccb4..5bb9df30 100644
--- a/app/src/command.c
+++ b/app/src/adb.c
@@ -1,15 +1,10 @@
-#include "command.h"
+#include "adb.h"
#include
+ * This is useful to restore some state when scrcpy is closed, even on device disconnection (which kills the scrcpy process).
+ */
+public final class CleanUp {
+
+ public static final String SERVER_PATH = "/data/local/tmp/scrcpy-server.jar";
+
+ // A simple struct to be passed from the main process to the cleanup process
+ public static class Config implements Parcelable {
+
+ public static final Creator
+ * Must be called before starting any new thread.
+ *
+ * @param level the log level
+ */
+ public static void initLogLevel(Level level) {
+ threshold = level;
+ }
+
public static boolean isEnabled(Level level) {
- return level.ordinal() >= THRESHOLD.ordinal();
+ return level.ordinal() >= threshold.ordinal();
+ }
+
+ public static void v(String message) {
+ if (isEnabled(Level.VERBOSE)) {
+ Log.v(TAG, message);
+ System.out.println(PREFIX + "VERBOSE: " + message);
+ }
}
public static void d(String message) {
diff --git a/server/src/main/java/com/genymobile/scrcpy/Options.java b/server/src/main/java/com/genymobile/scrcpy/Options.java
index 5b993f30..cf11df0f 100644
--- a/server/src/main/java/com/genymobile/scrcpy/Options.java
+++ b/server/src/main/java/com/genymobile/scrcpy/Options.java
@@ -3,13 +3,29 @@ package com.genymobile.scrcpy;
import android.graphics.Rect;
public class Options {
+ private Ln.Level logLevel;
private int maxSize;
private int bitRate;
private int maxFps;
+ private int lockedVideoOrientation;
private boolean tunnelForward;
private Rect crop;
private boolean sendFrameMeta; // send PTS so that the client may record properly
private boolean control;
+ private int displayId;
+ private boolean showTouches;
+ private boolean stayAwake;
+ private String codecOptions;
+ private String encoderName;
+ private boolean powerOffScreenOnClose;
+
+ public Ln.Level getLogLevel() {
+ return logLevel;
+ }
+
+ public void setLogLevel(Ln.Level logLevel) {
+ this.logLevel = logLevel;
+ }
public int getMaxSize() {
return maxSize;
@@ -35,6 +51,14 @@ public class Options {
this.maxFps = maxFps;
}
+ public int getLockedVideoOrientation() {
+ return lockedVideoOrientation;
+ }
+
+ public void setLockedVideoOrientation(int lockedVideoOrientation) {
+ this.lockedVideoOrientation = lockedVideoOrientation;
+ }
+
public boolean isTunnelForward() {
return tunnelForward;
}
@@ -66,4 +90,52 @@ public class Options {
public void setControl(boolean control) {
this.control = control;
}
+
+ public int getDisplayId() {
+ return displayId;
+ }
+
+ public void setDisplayId(int displayId) {
+ this.displayId = displayId;
+ }
+
+ public boolean getShowTouches() {
+ return showTouches;
+ }
+
+ public void setShowTouches(boolean showTouches) {
+ this.showTouches = showTouches;
+ }
+
+ public boolean getStayAwake() {
+ return stayAwake;
+ }
+
+ public void setStayAwake(boolean stayAwake) {
+ this.stayAwake = stayAwake;
+ }
+
+ public String getCodecOptions() {
+ return codecOptions;
+ }
+
+ public void setCodecOptions(String codecOptions) {
+ this.codecOptions = codecOptions;
+ }
+
+ public String getEncoderName() {
+ return encoderName;
+ }
+
+ public void setEncoderName(String encoderName) {
+ this.encoderName = encoderName;
+ }
+
+ public void setPowerOffScreenOnClose(boolean powerOffScreenOnClose) {
+ this.powerOffScreenOnClose = powerOffScreenOnClose;
+ }
+
+ public boolean getPowerOffScreenOnClose() {
+ return this.powerOffScreenOnClose;
+ }
}
diff --git a/server/src/main/java/com/genymobile/scrcpy/Position.java b/server/src/main/java/com/genymobile/scrcpy/Position.java
index b46d2f73..e9b6d8a2 100644
--- a/server/src/main/java/com/genymobile/scrcpy/Position.java
+++ b/server/src/main/java/com/genymobile/scrcpy/Position.java
@@ -23,6 +23,19 @@ public class Position {
return screenSize;
}
+ public Position rotate(int rotation) {
+ switch (rotation) {
+ case 1:
+ return new Position(new Point(screenSize.getHeight() - point.getY(), point.getX()), screenSize.rotate());
+ case 2:
+ return new Position(new Point(screenSize.getWidth() - point.getX(), screenSize.getHeight() - point.getY()), screenSize);
+ case 3:
+ return new Position(new Point(point.getY(), screenSize.getWidth() - point.getX()), screenSize.rotate());
+ default:
+ return this;
+ }
+ }
+
@Override
public boolean equals(Object o) {
if (this == o) {
diff --git a/server/src/main/java/com/genymobile/scrcpy/ScreenEncoder.java b/server/src/main/java/com/genymobile/scrcpy/ScreenEncoder.java
index c9a37f84..2f7109c5 100644
--- a/server/src/main/java/com/genymobile/scrcpy/ScreenEncoder.java
+++ b/server/src/main/java/com/genymobile/scrcpy/ScreenEncoder.java
@@ -5,6 +5,7 @@ import com.genymobile.scrcpy.wrappers.SurfaceControl;
import android.graphics.Rect;
import android.media.MediaCodec;
import android.media.MediaCodecInfo;
+import android.media.MediaCodecList;
import android.media.MediaFormat;
import android.os.Build;
import android.os.IBinder;
@@ -13,33 +14,35 @@ import android.view.Surface;
import java.io.FileDescriptor;
import java.io.IOException;
import java.nio.ByteBuffer;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
import java.util.concurrent.atomic.AtomicBoolean;
public class ScreenEncoder implements Device.RotationListener {
private static final int DEFAULT_I_FRAME_INTERVAL = 10; // seconds
private static final int REPEAT_FRAME_DELAY_US = 100_000; // repeat after 100ms
+ private static final String KEY_MAX_FPS_TO_ENCODER = "max-fps-to-encoder";
private static final int NO_PTS = -1;
private final AtomicBoolean rotationChanged = new AtomicBoolean();
private final ByteBuffer headerBuffer = ByteBuffer.allocate(12);
+ private String encoderName;
+ private List
+ * However, it does not include the locked video orientation.
+ */
+ private final Size unlockedVideoSize;
+
+ /**
+ * Device rotation, related to the natural device orientation (0, 1, 2 or 3)
+ */
+ private final int deviceRotation;
+
+ /**
+ * The locked video orientation (-1: disabled, 0: normal, 1: 90° CCW, 2: 180°, 3: 90° CW)
+ */
+ private final int lockedVideoOrientation;
+
+ public ScreenInfo(Rect contentRect, Size unlockedVideoSize, int deviceRotation, int lockedVideoOrientation) {
this.contentRect = contentRect;
- this.videoSize = videoSize;
- this.rotated = rotated;
+ this.unlockedVideoSize = unlockedVideoSize;
+ this.deviceRotation = deviceRotation;
+ this.lockedVideoOrientation = lockedVideoOrientation;
}
public Rect getContentRect() {
return contentRect;
}
- public Size getVideoSize() {
- return videoSize;
+ /**
+ * Return the video size as if locked video orientation was not set.
+ *
+ * @return the unlocked video size
+ */
+ public Size getUnlockedVideoSize() {
+ return unlockedVideoSize;
}
- public ScreenInfo withRotation(int rotation) {
- boolean newRotated = (rotation & 1) != 0;
- if (rotated == newRotated) {
+ /**
+ * Return the actual video size if locked video orientation is set.
+ *
+ * @return the actual video size
+ */
+ public Size getVideoSize() {
+ if (getVideoRotation() % 2 == 0) {
+ return unlockedVideoSize;
+ }
+
+ return unlockedVideoSize.rotate();
+ }
+
+ public int getDeviceRotation() {
+ return deviceRotation;
+ }
+
+ public ScreenInfo withDeviceRotation(int newDeviceRotation) {
+ if (newDeviceRotation == deviceRotation) {
return this;
}
- return new ScreenInfo(Device.flipRect(contentRect), videoSize.rotate(), newRotated);
+ // true if changed between portrait and landscape
+ boolean orientationChanged = (deviceRotation + newDeviceRotation) % 2 != 0;
+ Rect newContentRect;
+ Size newUnlockedVideoSize;
+ if (orientationChanged) {
+ newContentRect = flipRect(contentRect);
+ newUnlockedVideoSize = unlockedVideoSize.rotate();
+ } else {
+ newContentRect = contentRect;
+ newUnlockedVideoSize = unlockedVideoSize;
+ }
+ return new ScreenInfo(newContentRect, newUnlockedVideoSize, newDeviceRotation, lockedVideoOrientation);
+ }
+
+ public static ScreenInfo computeScreenInfo(DisplayInfo displayInfo, Rect crop, int maxSize, int lockedVideoOrientation) {
+ int rotation = displayInfo.getRotation();
+
+ if (lockedVideoOrientation == Device.LOCK_VIDEO_ORIENTATION_INITIAL) {
+ // The user requested to lock the video orientation to the current orientation
+ lockedVideoOrientation = rotation;
+ }
+
+ Size deviceSize = displayInfo.getSize();
+ Rect contentRect = new Rect(0, 0, deviceSize.getWidth(), deviceSize.getHeight());
+ if (crop != null) {
+ if (rotation % 2 != 0) { // 180s preserve dimensions
+ // the crop (provided by the user) is expressed in the natural orientation
+ crop = flipRect(crop);
+ }
+ if (!contentRect.intersect(crop)) {
+ // intersect() changes contentRect so that it is intersected with crop
+ Ln.w("Crop rectangle (" + formatCrop(crop) + ") does not intersect device screen (" + formatCrop(deviceSize.toRect()) + ")");
+ contentRect = new Rect(); // empty
+ }
+ }
+
+ Size videoSize = computeVideoSize(contentRect.width(), contentRect.height(), maxSize);
+ return new ScreenInfo(contentRect, videoSize, rotation, lockedVideoOrientation);
+ }
+
+ private static String formatCrop(Rect rect) {
+ return rect.width() + ":" + rect.height() + ":" + rect.left + ":" + rect.top;
+ }
+
+ private static Size computeVideoSize(int w, int h, int maxSize) {
+ // Compute the video size and the padding of the content inside this video.
+ // Principle:
+ // - scale down the great side of the screen to maxSize (if necessary);
+ // - scale down the other side so that the aspect ratio is preserved;
+ // - round this value to the nearest multiple of 8 (H.264 only accepts multiples of 8)
+ w &= ~7; // in case it's not a multiple of 8
+ h &= ~7;
+ if (maxSize > 0) {
+ if (BuildConfig.DEBUG && maxSize % 8 != 0) {
+ throw new AssertionError("Max size must be a multiple of 8");
+ }
+ boolean portrait = h > w;
+ int major = portrait ? h : w;
+ int minor = portrait ? w : h;
+ if (major > maxSize) {
+ int minorExact = minor * maxSize / major;
+ // +4 to round the value to the nearest multiple of 8
+ minor = (minorExact + 4) & ~7;
+ major = maxSize;
+ }
+ w = portrait ? minor : major;
+ h = portrait ? major : minor;
+ }
+ return new Size(w, h);
+ }
+
+ private static Rect flipRect(Rect crop) {
+ return new Rect(crop.top, crop.left, crop.bottom, crop.right);
+ }
+
+ /**
+ * Return the rotation to apply to the device rotation to get the requested locked video orientation
+ *
+ * @return the rotation offset
+ */
+ public int getVideoRotation() {
+ if (lockedVideoOrientation == -1) {
+ // no offset
+ return 0;
+ }
+ return (deviceRotation + 4 - lockedVideoOrientation) % 4;
+ }
+
+ /**
+ * Return the rotation to apply to the requested locked video orientation to get the device rotation
+ *
+ * @return the (reverse) rotation offset
+ */
+ public int getReverseVideoRotation() {
+ if (lockedVideoOrientation == -1) {
+ // no offset
+ return 0;
+ }
+ return (lockedVideoOrientation + 4 - deviceRotation) % 4;
}
}
diff --git a/server/src/main/java/com/genymobile/scrcpy/Server.java b/server/src/main/java/com/genymobile/scrcpy/Server.java
index 56b738fb..fdd9db88 100644
--- a/server/src/main/java/com/genymobile/scrcpy/Server.java
+++ b/server/src/main/java/com/genymobile/scrcpy/Server.java
@@ -1,32 +1,78 @@
package com.genymobile.scrcpy;
+import com.genymobile.scrcpy.wrappers.ContentProvider;
+
import android.graphics.Rect;
import android.media.MediaCodec;
+import android.media.MediaCodecInfo;
+import android.os.BatteryManager;
import android.os.Build;
-import java.io.File;
import java.io.IOException;
+import java.util.List;
+import java.util.Locale;
public final class Server {
- private static final String SERVER_PATH = "/data/local/tmp/scrcpy-server.jar";
private Server() {
// not instantiable
}
private static void scrcpy(Options options) throws IOException {
+ Ln.i("Device: " + Build.MANUFACTURER + " " + Build.MODEL + " (Android " + Build.VERSION.RELEASE + ")");
final Device device = new Device(options);
- boolean tunnelForward = options.isTunnelForward();
- try (DesktopConnection connection = DesktopConnection.open(device, tunnelForward)) {
- ScreenEncoder screenEncoder = new ScreenEncoder(options.getSendFrameMeta(), options.getBitRate(), options.getMaxFps());
+ List