genymobile/scrcpyAffichez et contrôlez votre appareil Android
> [!WARNING]
> **Ce dépôt GitHub (<https://github.com/Genymobile/scrcpy>) est la seule source
officielle du projet. Ne téléchargez pas les versions depuis des sites web aléatoires, même si
leur nom contient `scrcpy`.**
# scrcpy (v5.0.1)
<img src="https://raw.githubusercontent.com/genymobile/scrcpy/HEAD/app/data/scrcpy.svg" width="128" height="128" alt="scrcpy" align="right" />
_se prononce "**scr**een **c**o**py**"_
Cette application reproduit les appareils Android (vidéo et audio) connectés via USB ou
[TCP/IP](https://github.com/genymobile/scrcpy/blob/master/doc/connection.md#tcpip-wireless) et permet de les contrôler à l'aide du
clavier et de la souris de l'ordinateur. Elle ne nécessite pas d'accès _root_ ni d'application
installée sur l'appareil. Elle fonctionne sous _Linux_, _Windows_ et _macOS_.
[](doc/linux.md)
[](doc/windows.md)
[](doc/macos.md)
Elle met l'accent sur :
- **la légèreté** : native, affiche uniquement l'écran de l'appareil
- **les performances** : 30~120fps, selon l'appareil
- **la qualité** : 1920×1080 ou plus
- **une faible latence** : [35~70ms][lowlatency]
- **un faible temps de démarrage** : ~1 seconde pour afficher la première image
- **la non-intrusivité** : rien n'est laissé installé sur l'appareil Android
- **des avantages pour l'utilisateur** : pas de compte, pas de publicité, pas besoin d'internet
- **la liberté** : logiciel libre et open source
[lowlatency]: https://github.com/Genymobile/scrcpy/pull/646
Ses fonctionnalités incluent :
- [le transfert audio](https://github.com/genymobile/scrcpy/blob/master/doc/audio.md) (Android 11+)
- [l'enregistrement](https://github.com/genymobile/scrcpy/blob/master/doc/recording.md)
- [l'affichage virtuel](https://github.com/genymobile/scrcpy/blob/master/doc/virtual-display.md)
- la mise en miroir avec [l'écran de l'appareil Android éteint](https://github.com/genymobile/scrcpy/blob/master/doc/device.md#turn-screen-off)
- [le copier-coller](https://github.com/genymobile/scrcpy/blob/master/doc/control.md#copy-paste) dans les deux sens
- [une qualité configurable](https://github.com/genymobile/scrcpy/blob/master/doc/video.md)
- [la mise en miroir de la caméra](https://github.com/genymobile/scrcpy/blob/master/doc/camera.md) (Android 12+)
- [la mise en miroir en tant que webcam (V4L2)](https://github.com/genymobile/scrcpy/blob/master/doc/v4l2.md) (Linux uniquement)
- la simulation de [clavier][hid-keyboard] et de [souris][hid-mouse] physiques (HID)
- la prise en charge de la [manette de jeu](https://github.com/genymobile/scrcpy/blob/master/doc/gamepad.md)
- [le mode OTG](https://github.com/genymobile/scrcpy/blob/master/doc/otg.md)
- et plus encore…
[hid-keyboard]: https://raw.githubusercontent.com/genymobile/scrcpy/master/doc/keyboard.md#physical-keyboard-simulation
[hid-mouse]: https://raw.githubusercontent.com/genymobile/scrcpy/master/doc/mouse.md#physical-mouse-simulation
## Prérequis
L'appareil Android nécessite au minimum l'API 21 (Android 5.0).
[Le transfert audio](https://github.com/genymobile/scrcpy/blob/master/doc/audio.md) est pris en charge pour l'API >= 30 (Android 11+).
Assurez-vous d'avoir [activé le débogage USB][enable-adb] sur votre ou vos appareils.
[enable-adb]: https://developer.android.com/studio/debug/dev-options#enable
Sur certains appareils (notamment Xiaomi), vous pourriez obtenir l'erreur suivante :
```
Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.
```
Dans ce cas, vous devez activer [une option supplémentaire][control] `USB debugging
(Security Settings)` (il s'agit d'un élément différent de `USB debugging`) pour le contrôler
à l'aide d'un clavier et d'une souris. Un redémarrage de l'appareil est nécessaire une fois cette
option activée.
[control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323
Notez que le débogage USB n'est pas requis pour exécuter scrcpy en [mode OTG](https://github.com/genymobile/scrcpy/blob/master/doc/otg.md).
## Obtenir l'application
- [Linux](https://github.com/genymobile/scrcpy/blob/master/doc/linux.md)
- [Windows](https://github.com/genymobile/scrcpy/blob/master/doc/windows.md) (lire [comment l'exécuter](https://github.com/genymobile/scrcpy/blob/master/doc/windows.md#run))
- [macOS](https://github.com/genymobile/scrcpy/blob/master/doc/macos.md)
## Astuces à connaître
- [Réduire la résolution](https://github.com/genymobile/scrcpy/blob/master/doc/video.md#size) peut grandement améliorer les performances
(`scrcpy -m1024`)
- Le [_clic droit_](https://github.com/genymobile/scrcpy/blob/master/doc/mouse.md#mouse-bindings) déclenche `BACK`
- Le [_clic du milieu_](https://github.com/genymobile/scrcpy/blob/master/doc/mouse.md#mouse-bindings) déclenche `HOME`
- <kbd>Alt</kbd>+<kbd>f</kbd> bascule le [plein écran](https://github.com/genymobile/scrcpy/blob/master/doc/window.md#fullscreen)
- Il existe de nombreux autres [raccourcis](https://github.com/genymobile/scrcpy/blob/master/doc/shortcuts.md)
## Exemples d'utilisation
Il existe de nombreuses options, [documentées](#user-documentation) dans des pages séparées.
Voici quelques exemples courants.
- Capturer l'écran en H.265 (meilleure qualité), limiter la taille à 1920, limiter
la fréquence d'images à 60 fps, désactiver l'audio et contrôler l'appareil en simulant
un clavier physique :
```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
```
- Démarrer VLC dans un nouvel affichage virtuel (séparé de l'affichage de l'appareil) :
```bash
scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
```
- Démarrer VLC dans un nouvel affichage _flex_ en utilisant H.265 avec un débit de 16 Mbps,
tout en maintenant l'affichage actif pour qu'il ne s'éteigne pas :
```bash
scrcpy --new-display -x --keep-active --start-app=org.videolan.vlc --video-codec=h265 -b16M
```
- Enregistrer la caméra de l'appareil en H.265 à 1920x1080 (et le microphone) dans un fichier
MP4 :
```bash
scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4
```
- Capturer la caméra frontale de l'appareil et l'exposer comme webcam sur l'ordinateur (sous
Linux) :
```bash
scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback
```
- Contrôler l'appareil sans miroir en simulant un clavier et une souris physiques
(débogage USB non requis) :
```bash
scrcpy --otg
```
- Contrôler l'appareil à l'aide de manettes branchées sur l'ordinateur :
```bash
scrcpy --gamepad=uhid
scrcpy -G # short version
```
## Documentation utilisateur
L'application offre de nombreuses fonctionnalités et options de configuration. Elles sont
documentées dans les pages suivantes :
- [Connexion](https://github.com/genymobile/scrcpy/blob/master/doc/connection.md)
- [Vidéo](https://github.com/genymobile/scrcpy/blob/master/doc/video.md)
- [Audio](https://github.com/genymobile/scrcpy/blob/master/doc/audio.md)
- [Contrôle](https://github.com/genymobile/scrcpy/blob/master/doc/control.md)
- [Clavier](https://github.com/genymobile/scrcpy/blob/master/doc/keyboard.md)
- [Souris](https://github.com/genymobile/scrcpy/blob/master/doc/mouse.md)
- [Manette](https://github.com/genymobile/scrcpy/blob/master/doc/gamepad.md)
- [Appareil](https://github.com/genymobile/scrcpy/blob/master/doc/device.md)
- [Fenêtre](https://github.com/genymobile/scrcpy/blob/master/doc/window.md)
- [Enregistrement](https://github.com/genymobile/scrcpy/blob/master/doc/recording.md)
- [Affichage virtuel](https://github.com/genymobile/scrcpy/blob/master/doc/virtual-display.md)
- [Tunnels](https://github.com/genymobile/scrcpy/blob/master/doc/tunnels.md)
- [OTG](https://github.com/genymobile/scrcpy/blob/master/doc/otg.md)
- [Caméra](https://github.com/genymobile/scrcpy/blob/master/doc/camera.md)
- [Video4Linux](https://github.com/genymobile/scrcpy/blob/master/doc/v4l2.md)
- [Raccourcis](https://github.com/genymobile/scrcpy/blob/master/doc/shortcuts.md)
## Ressources
- [FAQ](https://github.com/genymobile/scrcpy/blob/master/FAQ.md)
- [Traductions][wiki] (pas nécessairement à jour)
- [Instructions de compilation](https://github.com/genymobile/scrcpy/blob/master/doc/build.md)
- [Développeurs](https://github.com/genymobile/scrcpy/blob/master/doc/develop.md)
- [Vérifier les signatures de version](https://github.com/genymobile/scrcpy/blob/master/doc/verify-release.md)
[wiki]: https://github.com/Genymobile/scrcpy/wiki
## Articles
- [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/
## Contact
Vous pouvez ouvrir un [ticket][issue] pour signaler des bugs, demander des fonctionnalités ou poser des questions générales.
Pour les rapports de bugs, veuillez d'abord lire la [FAQ](https://github.com/genymobile/scrcpy/blob/master/FAQ.md), vous pourriez trouver une solution
à votre problème immédiatement.
[issue]: https://github.com/Genymobile/scrcpy/issues
Vous pouvez également utiliser :
- 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)
## Faire un don
Je suis [@rom1v](https://github.com/rom1v), l'auteur et mainteneur de _scrcpy_.
Si vous appréciez cette application, vous pouvez [soutenir mon travail 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
## Licence
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.