| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| scrcpy [Le 19/07/2025, 02:42] – réécriture / reformulations / corrections mise en forme / etc. / câble usagàé ça nexiste pas, par contre les mauvais cables sont très courants ! krodelabestiole | scrcpy [Le 10/01/2026, 20:45] (Version actuelle) – [Scrcpy] krodelabestiole |
|---|
| {{tag>Noble Application Android Partage Ecran}} | {{tag>Noble Application Android Partage Ecran}} |
| |
| {{ :scrcpy.png?100|Logo Scrcpy}} | {{ :scrcpy.png?100|Icône scrcpy}} |
| ====== Scrcpy ====== | ====== Scrcpy ====== |
| |
| **Scrcpy** repose sur [[wpfr>Android_SDK#Android_Debug_Bridge|ADB]] (//Android Debug Bridge//), il s'agit d'une fonctionnalité initialement implémentée pour les développeurs, mais présente sur tous les appareils Android.\\ | **Scrcpy** repose sur [[wpfr>Android_SDK#Android_Debug_Bridge|ADB]] (//Android Debug Bridge//), il s'agit d'une fonctionnalité initialement implémentée pour les développeurs, mais présente sur tous les appareils Android.\\ |
| Il est assez simple de l'utiliser avec un câble USB, et un peu plus compliqué de l'utiliser sans câble, via [[:WiFi]]. | Il est assez simple de l'utiliser avec un câble USB, et un peu plus compliqué de l'utiliser sans câble, via [[:WiFi]]. |
| | |
| | <note tip> |
| | L'application [[https://github.com/IshuSinghSE/aurynk|Aurynk]] est basée sur [[:scrcpy]], mieux intégrée au bureau [[:GNOME]] et facilite la connexion même WiFi à l'aide d'un QR code. |
| | |
| | Elle est disponible en [[:Flatpak]] sur le dépôt [[https://flathub.org/fr/apps/io.github.IshuSinghSE.aurynk|Flathub]] et peut donc s'installer en suivant [[:tutoriel:installer_application_flatpak|cette procédure]] puis en installant le paquet ''[[https://flathub.org/fr/apps/io.github.IshuSinghSE.aurynk|io.github.IshuSinghSE.aurynk]]''. |
| | |
| | C'est une autre manière simple d'installer et d'utiliser **scrcpy** sur Ubuntu. |
| | </note> |
| |
| ===== Pré-requis ===== | ===== Pré-requis ===== |
| ===== Installation ===== | ===== Installation ===== |
| |
| **Scrcpy** utilise des fonctions natives d'Android pour fonctionner, il n'y a donc rien à installer sur son smartphone (voir par contre la note ci-dessous pour activer ces fonctions). | **Scrcpy** utilise des fonctions natives d'Android pour fonctionner, il n'y a donc rien à installer sur son smartphone. |
| |
| Il existe deux méthodes simples, //au choix//, pour installer **Scrcpy** sur Ubuntu : | <note important> |
| * Il est disponible en [[:deb]] dans les [[:depots#dépôts officiels]] [[:APT]] d'Ubuntu.\\ Pour l'installer il suffit donc d'[[:tutoriel:comment_installer_un_paquet|installer les paquets]] ''[[apt>adb]]'' et ''[[apt>scrcpy]]'' . | Pensez par contre à activer sur votre téléphone le **débogage USB** (accessible en mode développeur) sans quoi **scrcpy** ne pourra pas fonctionner : |
| | * Sur votre téléphone : dans les paramètres ''⚙'' -> //À propos du téléphone// -> tapotez **7 fois** sur le //Numéro de build//\\ => le menu //Options pour les développeurs// apparaît alors : |
| | * Retournez dans les paramètres ''⚙'' -> //Système// -> //Options pour les développeurs// -> activez **//Débogage USB//**. |
| | </note> |
| |
| * **Scrcpy** est aussi proposé de manière non-officielle en [[:snap]] sur [[https://snapcraft.io/scrcpy|Snapcraft]].\\ On peut donc simplement installer l'application ''scrcpy [unofficial]'' depuis le [[:snap store|centre d'applications]], ou installer le paquet ''scrcpy'' en ligne de commande : <code>snap install scrcpy</code> | Côté Ubuntu il existe plusieurs méthodes, //au choix//, pour installer **scrcpy** : |
| | * Il est disponible en [[:deb]] dans les [[#dépôts officiels APT]] d'Ubuntu. |
| | * Il existe aussi un paquet [[#snap]] non-officiel. |
| | * Il est aussi distribué par ses développeurs en tant que fichiers binaires isolés, et peut donc s'[[#Installation manuelle|installer manuellement]]. |
| |
| <note important>Pensez à activer sur votre téléphone le **débogage USB** (accessible en mode développeur) sans quoi **Scrcpy** ne pourra pas fonctionner : | <note tip> |
| * Sur votre téléphone : dans les paramètres (⚙) -> //À propos du téléphone// -> tapotez **7 fois** sur le //Numéro de build// => le menu //Options pour les développeurs// apparaît alors : | Vous trouverez aussi des informations concernant le téléchargement et l'installation de **scrcpy** en anglais sur son [[https://github.com/Genymobile/scrcpy/blob/master/doc/linux.md|site officiel]]. |
| * Retournez dans les paramètres (⚙) -> //Système// -> //Options pour les développeurs// -> activez **//Débogage USB//**. | |
| </note> | </note> |
| | |
| | Pour l'installer vous avez donc le choix entre l'une de ces méthodes : |
| | |
| | ==== Dépôts officiels APT ==== |
| | |
| | **Scrcpy** est disponible dans les [[:depots#dépôts officiels]] [[:APT]] d'Ubuntu. |
| | |
| | Pour obtenir cette application il suffit donc d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] ''[[apt>scrcpy]]''. |
| | |
| | ==== Snap ==== |
| | |
| | **Scrcpy** est disponible en [[:Snap]] depuis [[https://snapcraft.io/scrcpy|Snapcraft]]. Il semble cependant rarement s'agir de la dernière version, et elle n'est pas officielle. Cette méthode n'est donc pas recommandée. |
| | |
| | On peut donc l'installer sur Ubuntu simplement en installant l'application ''scrcpy [unofficial]'' depuis le [[:snap store|centre d'applications (Snap Store)]], ou en installant le paquet ''scrcpy'' en ligne de commande : |
| | <code>snap install scrcpy</code> |
| | |
| | ==== Installation manuelle ==== |
| | |
| | **Scrcpy** est aussi distribué par ses développeurs sur [[https://github.com/Genymobile/scrcpy/releases/latest|GitHub]]. |
| | |
| | <note important> |
| | Cette méthode ne permet pas de mise à jour automatique et n'intègre pas **scrcpy** au bureau. Il faudra créer un [[:raccourci-lanceur|lanceur]] manuellement. |
| | </note> |
| | |
| | Pour l'installer on peut donc simplement extraire le fichier ''.tar.gz'' correspondant, et placer le fichier ''scrcpy'' en ajustant ses [[:permissions]] pour le rendre exécutable, soit dans le répertoire des [[:arborescence#binaires personnels]] ''~/.local/bin/'', soit avec les [[:sudo|droits d'administrateur]] dans le répertoire ''/usr/local/bin/''. |
| | |
| | Pour la première méthode en ligne de commande : |
| | - Commencer par télécharger la dernière version (adaptez ''3.3.3'' si nécessaire) :<code>wget https://github.com/Genymobile/scrcpy/releases/download/v3.3.3/scrcpy-linux-x86_64-v3.3.3.tar.gz</code> |
| | - Extraire les fichiers :<code>tar -xzvf scrcpy-linux-x86_64-v3.3.3.tar.gz</code> |
| | - Les déplacer vers le répertoire des [[:arborescence#binaires personnels]] :<code>mv scrcpy-linux-x86_64-v3.3.3 ~/.local/bin/</code> |
| | - Créer un lien symbolique pour que la commande soit accessible :<code>ln -s ~/.local/bin/scrcpy-linux-x86_64-v3.3.3/scrcpy ~/.local/bin/</code> |
| | - Finalement supprimer l'archive :<code>rm scrcpy-linux-x86_64-v3.3.3.tar.gz</code> |
| | |
| | La commande ''[[man>scrcpy]]'' sera alors disponible. |
| | |
| | === Lanceur === |
| | |
| | Si vous avez besoin d'un [[:raccourci-lanceur|lanceur]] avec cette installation manuelle, vous pouvez déplacer l'[[https://raw.githubusercontent.com/Genymobile/scrcpy/refs/heads/master/app/data/icon.svg|icône]] au bon endroit : |
| | mv ~/.local/bin/scrcpy-linux-x86_64-v3.3.3/icon.png ~/.local/share/icons/scrcpy.png |
| | |
| | puis [[:tutoriel:comment_modifier_un_fichier|créer un fichier]] ''~/.local/share/applications/scrcpy.desktop'' contenant : |
| | |
| | <file - scrcpy.desktop> |
| | [Desktop Entry] |
| | Version=1.0 |
| | Name=scrcpy |
| | Comment=Affiche et contrôle votre appareil Android |
| | Exec=scrcpy -wS |
| | Terminal=false |
| | Type=Application |
| | Icon=scrcpy |
| | Categories=Utility;RemoteAccess; |
| | StartupNotify=true |
| | </file> |
| |
| ===== Utilisation simplifiée ===== | ===== Utilisation simplifiée ===== |
| ==== Lanceur ==== | ==== Lanceur ==== |
| |
| À l'origine, **scrcpy** ne créait pas de [[:raccourci-lanceur|lanceur]]. Désormais il en crée un, mais avec l'option de lancement par défaut "**scrcpy**" qui fait que la réplication s'éteint dès que l'écran du smartphone s'éteint. | À l'origine, **scrcpy** ne créait pas de [[:raccourci-lanceur|lanceur]]. Désormais il en crée un, mais avec l'option de lancement par défaut ''[[man>scrcpy]]'' qui fait que la réplication s'éteint dès que l'écran du smartphone s'éteint. |
| |
| Il peut être intéressant de créer un lanceur avec une option de lancement telle que ''-wS'' qui n'éteint pas la réplication à chaque fois que l'écran du smartphone se met en veille. Pour créer votre propre lanceur, le fichier ''.desktop'' doit ressembler à celui-ci : | Il peut être intéressant de modifier ce lanceur ou même d'en créer un nouveau avec une option de lancement telle que ''-wS'' qui n'éteint pas la réplication à chaque fois que l'écran du smartphone se met en veille. Pour créer votre propre lanceur, voir le chapitre //[[#Lanceur]]//.\\ |
| [Desktop Entry] | Vous pouvez bien sûr changer l'icône, le nom, le commentaire, les options de lancement de **scrcpy**, ... |
| Version=1.0 | |
| Type=Application | |
| Categories=Utility | |
| Name=Téléphone - scrcpy | |
| Comment=Réplication écran Androïd sur écran PC | |
| Exec=scrcpy -wS | |
| Icon=android-file-transfer | |
| Path= | |
| Terminal=false | |
| StartupNotify=false | |
| | |
| Vous donnez à ce fichier un nom quelconque en ''.desktop'', par exemple ''scrcpy.desktop'', et placez-le dans ''~/.local/share/applications/''. Vous pouvez bien sur changer l'icône, le nom, le commentaire, les options de lancement de **scrcpy**, ... | |
| |
| ==== Raccourcis ==== | ==== Raccourcis ==== |
| Des raccourcis sont disponibles pour utiliser son smartphone | Des raccourcis sont disponibles pour utiliser son smartphone |
| |
| ''Ctrl+H'' Il fait un retour menu. | ''Ctrl''+''H'' Il fait un retour menu. |
| |
| ''Ctrl+B'' Il fait un retour en arrière. | ''Ctrl''+''B'' Il fait un retour en arrière. |
| |
| ''Ctrl+S'' Il va dans le multi-tache. | ''Ctrl''+''S'' Il va dans le multi-tache. |
| |
| ''Clic droit'' Allume le smartphone. | ''Clic droit'' Allume le smartphone. |
| |
| ''Ctrl+P'' Allume/Éteint le smartphone. | ''Ctrl''+''P'' Allume/Éteint le smartphone. |
| |
| ''Ctrl+O'' Éteint l’écran du smartphone. | ''Ctrl''+''O'' Éteint l’écran du smartphone. |
| |
| ''Ctrl+R'' Tourne l’écran si possible. | ''Ctrl+R'' Tourne l’écran si possible. |
| |
| ''Ctrl+N'' Ouvre le panel de notification. | ''Ctrl''+''N'' Ouvre le panel de notification. |
| |
| ''Ctrl+Shift+N'' Ferme le panel de notification. | ''Ctrl''+''Maj''+''N'' Ferme le panel de notification. |
| |
| ==== Connexion sans câble ==== | ==== Connexion sans câble ==== |
| Avant d'utiliser **scrcpy** sans câble ([[:WiFi]]) il est préférable de tester //avec// un câble pour voir si tout fonctionne correctement. | Avant d'utiliser **scrcpy** sans câble ([[:WiFi]]) il est préférable de tester //avec// un câble pour voir si tout fonctionne correctement. |
| |
| Pour que cette méthode fonctionne rendez vous sur Android dans les paramètres (⚙) -> //Système// -> //Options pour les développeurs// -> activez **//Débogage sans fil//** (ou **//ADB par réseau//** sur les très anciens systèmes). | Pour que cette méthode fonctionne rendez vous sur Android dans les paramètres ''⚙'' -> //Système// -> //Options pour les développeurs// -> activez **//Débogage sans fil//** (ou **//ADB par réseau//** sur les très anciens systèmes). |
| |
| <note important>**Attention cependant :** cette action rend l'appareil vulnérable à des attaques depuis n'importe quelle machine connectée au même réseau. Pensez à désactiver cette option lorsque vous n'en avez plus besoin.</note> | <note important>**Attention cependant :** cette action rend l'appareil vulnérable à des attaques depuis n'importe quelle machine connectée au même réseau. Pensez à désactiver cette option lorsque vous n'en avez plus besoin.</note> |
| |
| L'utilisation sous [[:Wayland]] peut poser problème. Voir : https://github.com/Genymobile/scrcpy/blob/master/FAQ.md#issue-with-wayland | L'utilisation sous [[:Wayland]] peut poser problème. Voir : https://github.com/Genymobile/scrcpy/blob/master/FAQ.md#issue-with-wayland |
| | |
| | ===== Désinstallation ===== |
| | |
| | Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. |
| | |
| | * Pour la version des **[[#dépôts officiels APT]]**, vous pouvez passer par le [[:snap store|centre d'applications]], ou en ligne de commande :<code>sudo apt remove scrcpy</code> |
| | * Pour la version **[[#snap]]**, vous pouvez aussi passer par le [[:snap store|centre d'applications]], ou en ligne de commande :<code>snap remove scrcpy</code> |
| | * Pour l'**[[#installation manuelle]]**, vous devez simplement supprimer les fichiers et répertoires créés :<code>rm -r ~/.local/bin/scrcpy ~/.local/bin/scrcpy-linux-x86_64-v3.3.3 ~/.local/share/applications/scrcpy.desktop ~/.local/share/icons/scrcpy.png</code> |
| | |
| |
| ===== Voir Aussi ===== | ===== Voir Aussi ===== |
| |
| * **(en)** [[https://github.com/Genymobile/scrcpy|Le github de l'application]] | * **(//en//)** Le [[https://github.com/Genymobile/scrcpy|GitHub]] de l'application est son seul site officiel. |
| * **(fr)** [[https://korben.info/scrcpy-un-outil-en-ligne-de-commande-pour-afficher-et-controler-un-appareil-android-depuis-son-ordinateur-linux-macos-windows.html|Article sur le site de Korben]] | |
| * **(fr)** [[https://linuxfr.org/users/rom1v/journaux/scrcpy-une-appli-pour-afficher-et-controler-des-devices-android|Article sur Linux.fr]] | * **(fr)** [[https://linuxfr.org/users/rom1v/journaux/scrcpy-une-appli-pour-afficher-et-controler-des-devices-android|Article sur Linux.fr]] |
| * [[:kdeconnect-kde|KDE Connect]], un autre logiciel permettant d'échanger avec un appareil Android. | * [[:kdeconnect-kde|KDE Connect]], un autre logiciel permettant d'échanger avec un appareil Android. |