genymobile/scrcpyAffichez et contrôlez votre appareil Android
Ce dépôt GitHub (https://github.com/Genymobile/scrcpy) est la seule source
officielle du projet. Ne téléchargez pas de versions depuis des sites aléatoires,
même si leur nom contient scrcpy.
se prononce « screen copy »
Cette application reflète les appareils Android (vidéo et audio) connectés via USB ou TCP/IP et permet de les contrôler avec le clavier et 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.
Elle met l’accent sur :
Ses fonctionnalités incluent :
L’appareil Android nécessite au moins l’API 21 (Android 5.0).
Le transfert audio est pris en charge pour API ≥ 30 (Android 11+).
Assurez-vous d’avoir activé le débogage USB sur votre (vos) appareil(s).
Sur certains appareils (surtout Xiaomi), vous pouvez 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 Débogage USB (paramètres de sécurité) (c’est un élément différent de Débogage USB) pour le
contrôler avec un clavier et une souris. Un redémarrage de l’appareil est nécessaire
une fois cette option définie.
Notez que le débogage USB n’est pas nécessaire pour exécuter scrcpy en mode OTG.
scrcpy -m1024)BACKHOMEIl existe de nombreuses options, documentées dans des pages séparées. Voici quelques exemples courants.
Capturer l’écran en H.265 (meilleure qualité), limiter la taille à 1920, limiter le taux d’images à 60 ips, désactiver l’audio et contrôler l’appareil en simulant un clavier physique :
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 # version courte
Lancer VLC dans un nouvel affichage virtuel (séparé de l’écran de l’appareil) :
scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
Lancer VLC dans un nouvel affichage flex avec H.265 à 16 Mbps, tout en gardant l’affichage actif pour qu’il ne s’éteigne pas :
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 à 1920×1080 (et le microphone) dans un fichier MP4 :
scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4
Capturer la caméra avant de l’appareil et l’exposer en tant que webcam sur l’ordinateur (sous Linux) :
scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback
Contrôler l’appareil sans mise en miroir en simulant un clavier et une souris physiques (débogage USB non requis) :
scrcpy --otg
L’application offre de nombreuses fonctionnalités et options de configuration. Elles sont documentées dans les pages suivantes :
Vous pouvez ouvrir un 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 ; vous pourriez y trouver une solution immédiate à votre problème.
Vous pouvez aussi utiliser :
r/scrcpy@scrcpy.bsky.social@scrcpy_appJe suis @rom1v, l’auteur et mainteneur de scrcpy.
Si vous appréciez cette application, vous pouvez soutenir mon travail open source :
Copyright (C) 2018 Genymobile
Copyright (C) 2018-2026 Romain Vimont
Sous licence Apache, version 2.0 (la « Licence ») ;
vous ne pouvez utiliser ce fichier qu’en conformité avec la Licence.
Vous pouvez obtenir une copie de la Licence à l’adresse suivante :
http://www.apache.org/licenses/LICENSE-2.0
Sauf si la loi applicable ou un accord écrit ne l’exige, le logiciel
distribué sous la Licence est distribué « EN L’ÉTAT »,
SANS GARANTIE OU CONDITION D’AUCUNE SORTE, expresse ou implicite.
Consultez la Licence pour connaître les autorisations et limitations
spécifiques régissant votre utilisation du logiciel.
Contrôler l’appareil avec des manettes branchées sur l’ordinateur :
scrcpy --gamepad=uhid
scrcpy -G # version courte