scrcpy/README.it.md

_Apri il [README](README.md) originale e sempre aggiornato._

# scrcpy (v1.19)

Questa applicazione fornisce la visualizzazione e il controllo dei dispositivi Android collegati via USB (o [via TCP/IP][article-tcpip]). Non richiede alcun accesso _root_.
Funziona su _GNU/Linux_, _Windows_ e _macOS_.

![screenshot](assets/screenshot-debian-600.jpg)

Si concentra su:

 - **leggerezza** (nativo, mostra solo lo schermo del dispositivo)
 - **prestazioni** (30~60fps)
 - **qualità** (1920×1080 o superiore)
 - **bassa latenza** ([35~70ms][lowlatency])
 - **tempo di avvio basso** (~ 1secondo per visualizzare la prima immagine)
 - **non invadenza** (nulla viene lasciato installato sul dispositivo)

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


## Requisiti

Il dispositivo Android richiede almeno le API 21 (Android 5.0).

Assiucurati di aver [attivato il debug usb][enable-adb] sul(/i) tuo(i) dispositivo(/i).

[enable-adb]: https://developer.android.com/studio/command-line/adb.html#Enabling

In alcuni dispositivi, devi anche abilitare [un'opzione aggiuntiva][control] per controllarli con tastiera e mouse.

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

## Ottieni l'app

<a href="https://repology.org/project/scrcpy/versions"><img src="https://repology.org/badge/vertical-allrepos/scrcpy.svg" alt="Packaging status" align="right"></a>

### 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     # orientamento iniziale (corrente)
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 _
```

### Cattura

#### 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


#### v4l2loopback

Su Linux è possibile inviare il flusso video ad un dispositivo v4l2 loopback, cosicchè un dispositivo Android possa essere aperto come una webcam da qualsiasi strumento compatibile con v4l2.

Il modulo `v4l2loopback` deve essere installato:

```bash
sudo apt install v4l2loopback-dkms
```

Per creare un dispositvo v4l2:

```bash
sudo modprobe v4l2loopback
```

Questo creerà un nuovo dispositivo video in `/dev/videoN` dove `N` è un intero (più [opzioni](https://github.com/umlaeute/v4l2loopback#options) sono disponibili per crere più dispositivi o dispositivi con ID specifici).

Per elencare i dispositvi attivati:

```bash
# necessita del pacchetto v4l-utils
v4l2-ctl --list-devices

# semplice ma potrebbe essere sufficiente
ls /dev/video*
```

Per avviare scrcpy utilizzando un v4l2 sink:

```bash
scrcpy --v4l2-sink=/dev/videoN
scrcpy --v4l2-sink=/dev/videoN --no-display  # disabilita la finestra di trasmissione
scrcpy --v4l2-sink=/dev/videoN -N            # versione corta
```

(sostituisci `N` con l'ID del dispositivo, controlla con `ls /dev/video*`)

Una volta abilitato, puoi aprire il tuo flusso video con uno strumento compatibile con v4l2:

```bash
ffplay -i /dev/videoN
vlc v4l2:///dev/videoN   # VLC potrebbe aggiungere del ritardo per il buffer
```

Per esempio potresti catturare il video in [OBS].

[OBS]: https://obsproject.com/


#### Buffering

È possibile aggiungere del buffer. Questo aumenta la latenza ma riduce il jitter (vedi [#2464]).

[#2464]: https://github.com/Genymobile/scrcpy/issues/2464

L'opzione è disponibile per il buffer della visualizzazione:

```bash
scrcpy --display-buffer=50  # aggiungi 50 ms di buffer per la visualizzazione
```

e per il V4L2 sink:

```bash
scrcpy --v4l2-buffer=500    #  aggiungi 50 ms di buffer per il v4l2 sink
```


### 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 <kbd>MOD</kbd>+<kbd>f</kbd>.

#### 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 <kbd>MOD</kbd>+<kbd>←</kbd>
_(sinistra)_ e <kbd>MOD</kbd>+<kbd>→</kbd> _(destra)_.

Notare che _scrcpy_ gestisce 3 diversi tipi di rotazione:
 - <kbd>MOD</kbd>+<kbd>r</kbd> 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 <kbd>MOD</kbd>+<kbd>←</kbd>/<kbd>MOD</kbd>+<kbd>→</kbd>) 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 <kbd>MOD</kbd>+<kbd>o</kbd> in qualsiasi momento.

Per riaccenderlo premere <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>o</kbd>.

In Android il pulsante `POWER` (tasto di accensione) accende sempre lo schermo. Per comodità, se `POWER` è inviato via scrcpy (con click destro o con <kbd>MOD</kbd>+<kbd>p</kbd>), 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
```


#### 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 <kbd>MOD</kbd>+<kbd>r</kbd> 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 <kbd>Ctrl</kbd> viene inoltrata al dispositivo. In particolare:
 - <kbd>Ctrl</kbd>+<kbd>c</kbd> copia
 - <kbd>Ctrl</kbd>+<kbd>x</kbd> taglia
 - <kbd>Ctrl</kbd>+<kbd>v</kbd> 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 <kbd>Ctrl</kbd>+<kbd>c</kbd>, e _K-9 Mail_ compone un nuovo messaggio.

Per copiare, tagliare e incollare in questi casi (ma è solo supportato in Android >= 7):
 - <kbd>MOD</kbd>+<kbd>c</kbd> inietta `COPY`
 - <kbd>MOD</kbd>+<kbd>x</kbd> inietta `CUT`
 - <kbd>MOD</kbd>+<kbd>v</kbd> inietta `PASTE` (dopo la sincronizzazione degli appunti da computer a dispositivo)

In aggiunta, <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>v</kbd> 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 <kbd>Ctrl</kbd>+<kbd>v</kbd> che con <kbd>MOD</kbd>+<kbd>v</kbd>) 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 <kbd>Ctrl</kbd>+<kbd>v</kbd> and <kbd>MOD</kbd>+<kbd>v</kbd> 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 <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>v</kbd>).

#### Pizzica per zoomare (pinch-to-zoom)

Per simulare il "pizzica per zoomare": <kbd>Ctrl</kbd>+_click e trascina_.

Più precisamente, tieni premuto <kbd>Ctrl</kbd> 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/Download` 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/Movies/
```


### 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, <kbd>MOD</kbd> è il modificatore delle scorciatoie. In maniera predefinita è <kbd>Alt</kbd> (sinistro) o <kbd>Super</kbd> (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
```

_<kbd>[Super]</kbd> è il pulsante <kbd>Windows</kbd> o <kbd>Cmd</kbd>._

[Super]: https://it.wikipedia.org/wiki/Tasto_Windows
<!-- https://en.wikipedia.org/wiki/Super_key_(keyboard_button) è la pagina originale di Wikipedia inglese, l'ho sostituita con una simile in quello italiano -->

 | Azione                                      |   Scorciatoia
 | ------------------------------------------- |:-----------------------------
 | Schermo intero                      | <kbd>MOD</kbd>+<kbd>f</kbd>
 | Rotazione schermo a sinistra                         | <kbd>MOD</kbd>+<kbd>←</kbd> _(sinistra)_
 | Rotazione schermo a destra                        | <kbd>MOD</kbd>+<kbd>→</kbd> _(destra)_
 | Ridimensiona finestra a 1:1 (pixel-perfect)        | <kbd>MOD</kbd>+<kbd>g</kbd>
 | Ridimensiona la finestra per rimuovere i bordi neri       | <kbd>MOD</kbd>+<kbd>w</kbd> \| _Doppio click sinistro¹_
 | Premi il tasto `HOME`                             | <kbd>MOD</kbd>+<kbd>h</kbd> \| _Click centrale_
 | Premi il tasto `BACK`                             | <kbd>MOD</kbd>+<kbd>b</kbd> \| _Click destro²_
 | Premi il tasto `APP_SWITCH`                       | <kbd>MOD</kbd>+<kbd>s</kbd> \| _4° click³_
 | Premi il tasto `MENU` (sblocca lo schermo)             | <kbd>MOD</kbd>+<kbd>m</kbd>
 | Premi il tasto `VOLUME_UP`                        | <kbd>MOD</kbd>+<kbd>↑</kbd> _(su)_
 | Premi il tasto `VOLUME_DOWN`                      | <kbd>MOD</kbd>+<kbd>↓</kbd> _(giù)_
 | Premi il tasto `POWER`                            | <kbd>MOD</kbd>+<kbd>p</kbd>
 | Accendi                                    | _Click destro²_
 | Spegni lo schermo del dispositivo (continua a trasmettere)     | <kbd>MOD</kbd>+<kbd>o</kbd>
 | Accendi lo schermo del dispositivo                       | <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>o</kbd>
 | Ruota lo schermo del dispositivo                        | <kbd>MOD</kbd>+<kbd>r</kbd>
 | Espandi il pannello delle notifiche                   | <kbd>MOD</kbd>+<kbd>n</kbd> \| _5° click³_
 | Espandi il pannello delle impostazioni                   | <kbd>MOD</kbd>+<kbd>n</kbd>+<kbd>n</kbd> \| _Doppio 5° click³_
 | Chiudi pannelli                 | <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>n</kbd>
 | Copia negli appunti⁴                          | <kbd>MOD</kbd>+<kbd>c</kbd>
 | Taglia negli appunti⁴                           | <kbd>MOD</kbd>+<kbd>x</kbd>
 | Sincronizza gli appunti e incolla⁴           | <kbd>MOD</kbd>+<kbd>v</kbd>
 | Inietta il testo degli appunti del computer              | <kbd>MOD</kbd>+<kbd>Shift</kbd>+<kbd>v</kbd>
 | Abilita/Disabilita il contatore FPS (su stdout)      | <kbd>MOD</kbd>+<kbd>i</kbd>
 | Pizzica per zoomare                               | <kbd>Ctrl</kbd>+_click e trascina_

_¹Doppio click sui bordi neri per rimuoverli._  
_²Il tasto destro accende lo schermo se era spento, preme BACK in caso contrario._  
_³4° e 5° pulsante del mouse, se il tuo mouse ne dispone._  
_⁴Solo in Android >= 7._

Le scorciatoie con pulsanti ripetuti sono eseguite rilasciando e premendo il pulsante una seconda volta. Per esempio, per eseguire "Espandi il pannello delle impostazioni":

1. Premi e tieni premuto <kbd>MOD</kbd>.
2. Poi premi due volte <kbd>n</kbd>.
3. Infine rilascia <kbd>MOD</kbd>.

Tutte le scorciatoie <kbd>Ctrl</kbd>+_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/