genymobile/scrcpyVisualizza e controlla il tuo dispositivo Android
> [!WARNING]
> **Questo repository GitHub (<https://github.com/Genymobile/scrcpy>) è l'unica fonte
ufficiale del progetto. Non scaricare le release da siti web casuali, anche se
il loro nome contiene `scrcpy`.**
# scrcpy (v5.0.1)
<img src="https://raw.githubusercontent.com/genymobile/scrcpy/HEAD/app/data/scrcpy.svg" width="128" height="128" alt="scrcpy" align="right" />
_si pronuncia "**scr**een **c**o**py**"_
Questa applicazione esegue il mirroring di dispositivi Android (video e audio) connessi via USB o
[TCP/IP](https://github.com/genymobile/scrcpy/blob/master/doc/connection.md#tcpip-wireless) e consente il controllo tramite la
tastiera e il mouse del computer. Non richiede accesso _root_ né un'app
installata sul dispositivo. Funziona su _Linux_, _Windows_ e _macOS_.
[](doc/linux.md)
[](doc/windows.md)
[](doc/macos.md)
Si concentra su:
- **leggerezza**: nativo, visualizza solo lo schermo del dispositivo
- **prestazioni**: 30~120fps, a seconda del dispositivo
- **qualità**: 1920×1080 o superiore
- **bassa latenza**: [35~70ms][lowlatency]
- **tempo di avvio ridotto**: ~1 secondo per visualizzare la prima immagine
- **non invasività**: nulla rimane installato sul dispositivo Android
- **vantaggi per l'utente**: nessun account, nessuna pubblicità, nessuna connessione internet richiesta
- **libertà**: software libero e open source
[lowlatency]: https://github.com/Genymobile/scrcpy/pull/646
Le sue funzionalità includono:
- [inoltro audio](https://github.com/genymobile/scrcpy/blob/master/doc/audio.md) (Android 11+)
- [registrazione](https://github.com/genymobile/scrcpy/blob/master/doc/recording.md)
- [display virtuale](https://github.com/genymobile/scrcpy/blob/master/doc/virtual-display.md)
- mirroring con [schermo del dispositivo Android spento](https://github.com/genymobile/scrcpy/blob/master/doc/device.md#turn-screen-off)
- [copia-incolla](https://github.com/genymobile/scrcpy/blob/master/doc/control.md#copy-paste) in entrambe le direzioni
- [qualità configurabile](https://github.com/genymobile/scrcpy/blob/master/doc/video.md)
- [mirroring della fotocamera](https://github.com/genymobile/scrcpy/blob/master/doc/camera.md) (Android 12+)
- [mirroring come webcam (V4L2)](https://github.com/genymobile/scrcpy/blob/master/doc/v4l2.md) (solo Linux)
- simulazione di [tastiera][hid-keyboard] e [mouse][hid-mouse] fisici (HID)
- supporto [gamepad](https://github.com/genymobile/scrcpy/blob/master/doc/gamepad.md)
- [modalità OTG](https://github.com/genymobile/scrcpy/blob/master/doc/otg.md)
- e altro ancora…
[hid-keyboard]: https://raw.githubusercontent.com/genymobile/scrcpy/master/doc/keyboard.md#physical-keyboard-simulation
[hid-mouse]: https://raw.githubusercontent.com/genymobile/scrcpy/master/doc/mouse.md#physical-mouse-simulation
## Prerequisiti
Il dispositivo Android richiede almeno API 21 (Android 5.0).
L'[inoltro audio](https://github.com/genymobile/scrcpy/blob/master/doc/audio.md) è supportato per API >= 30 (Android 11+).
Assicurati di aver [abilitato il debug USB][enable-adb] sul/sui tuo/i dispositivo/i.
[enable-adb]: https://developer.android.com/studio/debug/dev-options#enable
Su alcuni dispositivi (in particolare Xiaomi), potresti ricevere il seguente errore:
```
Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.
```
In tal caso, è necessario abilitare [un'opzione aggiuntiva][control] `USB debugging
(Security Settings)` (si tratta di una voce diversa da `USB debugging`) per controllarlo
tramite tastiera e mouse. È necessario riavviare il dispositivo una volta impostata
questa opzione.
[control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323
Nota che il debug USB non è necessario per eseguire scrcpy in [modalità OTG](https://github.com/genymobile/scrcpy/blob/master/doc/otg.md).
## Ottenere l'app
- [Linux](https://github.com/genymobile/scrcpy/blob/master/doc/linux.md)
- [Windows](https://github.com/genymobile/scrcpy/blob/master/doc/windows.md) (leggi [come eseguirlo](https://github.com/genymobile/scrcpy/blob/master/doc/windows.md#run))
- [macOS](https://github.com/genymobile/scrcpy/blob/master/doc/macos.md)
## Suggerimenti da conoscere
- [Ridurre la risoluzione](https://github.com/genymobile/scrcpy/blob/master/doc/video.md#size) può migliorare notevolmente le prestazioni
(`scrcpy -m1024`)
- Il [_clic destro_](https://github.com/genymobile/scrcpy/blob/master/doc/mouse.md#mouse-bindings) attiva `BACK`
- Il [_clic centrale_](https://github.com/genymobile/scrcpy/blob/master/doc/mouse.md#mouse-bindings) attiva `HOME`
- <kbd>Alt</kbd>+<kbd>f</kbd> attiva/disattiva lo [schermo intero](https://github.com/genymobile/scrcpy/blob/master/doc/window.md#fullscreen)
- Ci sono molte altre [scorciatoie](https://github.com/genymobile/scrcpy/blob/master/doc/shortcuts.md)
## Esempi di utilizzo
Ci sono molte opzioni, [documentate](#user-documentation) in pagine separate.
Ecco solo alcuni esempi comuni.
- Catturare lo schermo in H.265 (qualità migliore), limitare la dimensione a 1920, limitare
la frequenza dei fotogrammi a 60fps, disabilitare l'audio e controllare il dispositivo simulando
una tastiera fisica:
```bash
scrcpy --video-codec=h265 --max-size=1920 --max-fps=60 --no-audio --keyboard=uhid
scrcpy --video-codec=h265 -m1920 --max-fps=60 --no-audio -K # short version
```
- Avviare VLC in un nuovo display virtuale (separato dal display del dispositivo):
```bash
scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
```
- Avviare VLC in un nuovo display _flex_ usando H.265 con un bitrate di 16 Mbps,
mantenendo il display attivo in modo che non si spenga:
```bash
scrcpy --new-display -x --keep-active --start-app=org.videolan.vlc --video-codec=h265 -b16M
```
- Registrare la fotocamera del dispositivo in H.265 a 1920x1080 (e il microfono) in un file
MP4:
```bash
scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4
```
- Catturare la fotocamera frontale del dispositivo ed esporla come webcam sul computer (su
Linux):
```bash
scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback
```
- Controllare il dispositivo senza mirroring simulando una tastiera e un mouse
fisici (debug USB non richiesto):
```bash
scrcpy --otg
```
- Controllare il dispositivo usando gamepad collegati al computer:
```bash
scrcpy --gamepad=uhid
scrcpy -G # short version
```
## Documentazione utente
L'applicazione offre molte funzionalità e opzioni di configurazione. Sono
documentate nelle seguenti pagine:
- [Connessione](https://github.com/genymobile/scrcpy/blob/master/doc/connection.md)
- [Video](https://github.com/genymobile/scrcpy/blob/master/doc/video.md)
- [Audio](https://github.com/genymobile/scrcpy/blob/master/doc/audio.md)
- [Controllo](https://github.com/genymobile/scrcpy/blob/master/doc/control.md)
- [Tastiera](https://github.com/genymobile/scrcpy/blob/master/doc/keyboard.md)
- [Mouse](https://github.com/genymobile/scrcpy/blob/master/doc/mouse.md)
- [Gamepad](https://github.com/genymobile/scrcpy/blob/master/doc/gamepad.md)
- [Dispositivo](https://github.com/genymobile/scrcpy/blob/master/doc/device.md)
- [Finestra](https://github.com/genymobile/scrcpy/blob/master/doc/window.md)
- [Registrazione](https://github.com/genymobile/scrcpy/blob/master/doc/recording.md)
- [Display virtuale](https://github.com/genymobile/scrcpy/blob/master/doc/virtual-display.md)
- [Tunnel](https://github.com/genymobile/scrcpy/blob/master/doc/tunnels.md)
- [OTG](https://github.com/genymobile/scrcpy/blob/master/doc/otg.md)
- [Fotocamera](https://github.com/genymobile/scrcpy/blob/master/doc/camera.md)
- [Video4Linux](https://github.com/genymobile/scrcpy/blob/master/doc/v4l2.md)
- [Scorciatoie](https://github.com/genymobile/scrcpy/blob/master/doc/shortcuts.md)
## Risorse
- [FAQ](https://github.com/genymobile/scrcpy/blob/master/FAQ.md)
- [Traduzioni][wiki] (non necessariamente aggiornate)
- [Istruzioni di compilazione](https://github.com/genymobile/scrcpy/blob/master/doc/build.md)
- [Sviluppatori](https://github.com/genymobile/scrcpy/blob/master/doc/develop.md)
- [Verifica delle firme di rilascio](https://github.com/genymobile/scrcpy/blob/master/doc/verify-release.md)
[wiki]: https://github.com/Genymobile/scrcpy/wiki
## Articoli
- [Introducing scrcpy][article-intro]
- [Scrcpy now works wirelessly][article-tcpip]
- [Scrcpy 2.0, with audio][article-scrcpy2]
[article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/
[article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/
[article-scrcpy2]: https://blog.rom1v.com/2023/03/scrcpy-2-0-with-audio/
## Contatti
Puoi aprire una [issue] per segnalazioni di bug, richieste di funzionalità o domande generali.
Per le segnalazioni di bug, leggi prima le [FAQ](https://github.com/genymobile/scrcpy/blob/master/FAQ.md), potresti trovare immediatamente
una soluzione al tuo problema.
[issue]: https://github.com/Genymobile/scrcpy/issues
Puoi anche usare:
- Reddit: [`r/scrcpy`](https://www.reddit.com/r/scrcpy)
- BlueSky: [`@scrcpy.bsky.social`](https://bsky.app/profile/scrcpy.bsky.social)
- Twitter: [`@scrcpy_app`](https://twitter.com/scrcpy_app)
## Dona
Sono [@rom1v](https://github.com/rom1v), l'autore e manutentore di _scrcpy_.
Se apprezzi questa applicazione, puoi [sostenere il mio lavoro open source][donate]:
- [GitHub Sponsors](https://github.com/sponsors/rom1v)
- [Liberapay](https://liberapay.com/rom1v/)
- [PayPal](https://paypal.me/rom2v)
[donate]: https://blog.rom1v.com/about/#support-my-open-source-work
## Licenza
Copyright (C) 2018 Genymobile
Copyright (C) 2018-2026 Romain Vimont
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.