| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| scrcpy [Le 16/12/2024, 14:20] – [Scrcpy] 195.220.0.178 | scrcpy [Le 10/01/2026, 20:45] (Version actuelle) – [Scrcpy] krodelabestiole |
|---|
| {{tag>Focal scrcpy Application Tutoriel Android Partage Ecran}} | {{tag>Noble Application Android Partage Ecran}} |
| |
| {{ :scrcpy.png?100|Logo Scrcpy}} | {{ :scrcpy.png?100|Icône scrcpy}} |
| | ====== Scrcpy ====== |
| |
| mange ma merde | **Scrcpy** (pour //**scr**een **c**o**py**//, //copie d'écran// en français) est un logiciel libre multiplate-forme (aussi disponible sur macOS et Windows) permettant d'utiliser ou de cloner l'affichage de son smartphone Android sur son ordinateur. Il propose les fonctionnalité d'un [[:bureau à distance]], mais pour visualiser ou contrôler un appareil Android : smartphone, tablette, ou smart TV. |
| | |
| | Votre téléphone devient alors pilotable depuis votre PC. Ceci permet par exemple d'utiliser sur son PC des applications qui sont purement Android, sans faire appel à un émulateur, ou simplement de profiter du confort d'un clavier, d'une souris et d'un grand écran pour utiliser son smartphone. |
| | |
| | **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]]. |
| | |
| | <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 ===== |
| |
| * Disposer des [[sudo|Droits de super utilisateur]]. | |
| * Disposer d'une connexion internet. | |
| * Un smartphone sous Android 5.0 ou plus. | * Un smartphone sous Android 5.0 ou plus. |
| * Un câble permettant de relier votre smartphone a votre ordinateur. | * Un câble USB de bonne qualité permettant de relier votre smartphone a votre ordinateur. |
| |
| ===== Installation ===== | ===== Installation ===== |
| [[:tutoriel:comment_installer_un_paquet|Installez les paquets]] suivants sur votre PC : **[[apt>adb|adb]]**, **[[apt>scrcpy|scrcpy]]** | |
| |
| <note important>Pensez à activer sur votre téléphone le **débogage USB** (mode développeur / ADB) sinon **Scrcpy** ne fonctionnera pas :\\ | **Scrcpy** utilise des fonctions natives d'Android pour fonctionner, il n'y a donc rien à installer sur son smartphone. |
| - Sur votre téléphone : Paramètres > Système > "À propos du téléphone" > Tapoter **7 fois** sur le « numéro de build » => Le menu « options pour développeurs » apparaît dans les paramètres système.\\ | |
| - Aller dans Paramètres > Système > « options pour développeurs » > activer "**débogage USB**". | <note important> |
| | 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> | </note> |
| |
| ===== Utilisation simplifiée ===== | Côté Ubuntu il existe plusieurs méthodes, //au choix//, pour installer **scrcpy** : |
| ==== Démarrage ==== | * 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]]. |
| |
| 1- le téléphone doit être actif, comme pour une utilisation normale. L'écran doit donc être déverrouillé de la façon habituelle (code PIN, empreinte digitale, ...). | <note tip> |
| | 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]]. |
| | </note> |
| |
| 2- Reliez le téléphone au PC par un câble USB (pour une connexion sans câble, voir plus loin). | Pour l'installer vous avez donc le choix entre l'une de ces méthodes : |
| |
| 3- Vérifiez que le débogage USB est bien actif côté téléphone. | ==== 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 ===== |
| | |
| | ==== Démarrage ==== |
| |
| 4- Lancez le logiciel (en tapant **scrcpy** ou mieux **scrcpy -w -S**) au terminal sur le PC, ou en cliquant sur un [[raccourci-lanceur|lanceur]] que vous aurez créé avec cette commande. | - le téléphone doit être actif, comme pour une utilisation normale. L'écran doit donc être déverrouillé de la façon habituelle (code PIN, empreinte digitale, ...). |
| | - Reliez le téléphone au PC par un câble USB (pour une connexion sans câble, voir plus loin). |
| | - Vérifiez que le débogage USB est bien actif côté téléphone. |
| | - Lancez le logiciel (en tapant ''scrcpy'' ou mieux ''scrcpy -w'') au terminal sur le PC, ou en cliquant sur un [[:raccourci-lanceur|lanceur]] que vous aurez créé avec cette commande. **/!\** Le téléphone peut vous poser une question pour valider la connexion : regardez l'écran du smartphone. |
| |
| La réplication de l'écran de votre téléphone apparaît sur celui de votre PC, après quelques secondes. | La réplication de l'écran de votre téléphone apparaît sur celui de votre PC, après quelques secondes. |
| Pour passer d'un écran virtuel du téléphone à un autre : faire tourner la molette de la souris. | Pour passer d'un écran virtuel du téléphone à un autre : faire tourner la molette de la souris. |
| |
| Pour revenir à l'écran en fermant une application : cliquer sur les flèches arrières, ou plus rapidement sur **ctrle + molette**. | Pour revenir à l'écran en fermant une application : cliquer sur les flèches arrières, ou plus rapidement sur ''Ctrl'' + molette. |
| |
| Pour fermer **scrcpy** : clic sur le bouton de fermeture de sa fenêtre. | Pour fermer **scrcpy** : clic sur le bouton de fermeture de sa fenêtre. |
| |
| {{:scrcpy.jpg?400|}} | {{:scrcpy.jpg?400}} |
| | |
| | La vidéo est déportée d'Android vers le PC comme les autres affichages. Vous pouvez même participer à des visioconférences. L'audio reste par contre cantonnée au smartphone, en entrée comme en sortie. Ce n'est normalement pas très gênant, mais si vous souhaitez également que le son passe du téléphone au PC, vous pouvez utiliser un plugin de **scrcpy**, du nom de **[[https://github.com/rom1v/sndcpy|sndcpy]]** (ce plugin n'est malheureusement pas disponible dans les dépôts d'Ubuntu). |
| |
| La vidéo est déportée d'Android vers le PC comme les autres affichages. Vous pouvez même faires des vidéo-conférences. Mais le son reste lui (entrée ou sortie) sur le smartphone. Ce n'est normalement pas très gênant, mais si vous souhaitez également que le son passe du téléphone au PC, vous pouvez utiliser un plugin à scrcpy, qui s'appelle [[https://github.com/rom1v/sndcpy|sndcpy]] (le plugin n'est pas dans les dépôts, en tout cas jusqu'à Ubuntu 22.04). | |
| ===== Utilisation avancée ===== | ===== Utilisation avancée ===== |
| |
| ==== Les principales options de commandes ==== | ==== Les principales options de commandes ==== |
| |
| Au **terminal** de votre PC (qui doit être connecté au téléphone). | Dans un [[:terminal]], saisir la [[:commande_shell|commande]] suivante sous Ubuntu : |
| scrcpy | scrcpy |
| Cette commande lance le logiciel et réplique le téléphone sur l'écran du PC (si le téléphone est connecté au PC et qu'il est activé / déverrouillé). | Cette commande lance le logiciel et réplique l'écran du téléphone sur celui du PC (si l'application fonctionne correctement). |
| |
| ou mieux : | ou si vous préférez éteindre l'écran du smartphone : |
| scrcpy -S | scrcpy -S |
| Cette option (-S) éteint l'écran du téléphone sans éteindre sa réplication sur votre écran de PC (économise la batterie du smartphone). | Cette option (''-S'') éteint l'écran du téléphone sans éteindre sa réplication sur votre écran de PC (ce qui permettrait d'économiser la batterie - cependant un smartphone se recharge lorsqu'il est connecté en USB). |
| | |
| Si lors d'un lancement du logiciel vous avez un message d'erreur au terminal du genre | |
| adb: error: failed to get feature set: no devices/emulators found | |
| l'autorisation ADB ("débogage USB") est sans doute à réactiver (l'option peut se désactiver lors de certaines manipulations, ou lors de l'extinction complète du téléphone). | |
| |
| __Attention__, si votre téléphone est prévu pour se mettre en veille au bout d'un délai (disons 1Mn), **scrcpy** ne l'empêchera pas : la réplication d'écran s'éteindra aussi sur votre PC. Un clic **droit** réactive l'écran, mais s'il faut un déblocage (type empreinte digitale, code, etc ...) il faudra le saisir pour que la réplication remontre le téléphone. Pour éviter le passage en veille du téléphone (tant qu'il est connecté à **scrcpy**) , il faut faire un | <note warning> |
| | Si votre téléphone est prévu pour se mettre en veille au bout d'un délai (disons 1Mn), **scrcpy** ne l'empêchera pas : la réplication d'écran s'éteindra aussi sur votre PC. Un clic //droit// réactive l'écran, mais s'il faut un déblocage (type empreinte digitale, code, etc ...) il faudra le saisir pour que la réplication remontre le téléphone. |
| | |
| | L'option ''-w'' permet d'empêcher le passage en veille du téléphone (tant qu'il est connecté à **scrcpy**) : |
| scrcpy -w | scrcpy -w |
| | </note> |
| | |
| On peut mixer les options. Ainsi le très utile : | On peut cumuler ces options. Ainsi le très utile : |
| scrcpy -w -S | scrcpy -wS |
| laisse la réplication d'écran sur votre PC tout le temps active (pas de passage en veille du téléphone), tout en éteignant l'écran du téléphone lui même (économie d'énergie). | laisse la réplication d'écran sur votre PC tout le temps active (pas de passage en veille du téléphone), tout en éteignant l'écran du téléphone lui même (économie d'énergie, s'il est utilisé sans câble). |
| |
| ==== Autres commandes ==== | ==== Autres commandes ==== |
| Cette application a plein de fonctionnalités que nous pouvons afficher en exécutant au terminal sur le PC : | |
| | Cette application propose quantité de fonctionnalités.\\ |
| | On peut les lister avec la commande : |
| scrcpy --help | scrcpy --help |
| |
| Voici une rapide présentation de quelques commandes utiles, additionnelles à celles déjà évoquées: | Voici une rapide présentation de quelques commandes utiles, additionnelles à celles déjà évoquées : |
| |
| La commande | |
| scrcpy --always-on-top | scrcpy --always-on-top |
| permet de mettre au premier plan la fenêtre. | permet de mettre au premier plan la fenêtre. |
| |
| La commande | |
| scrcpy -n | scrcpy -n |
| permet de faire un clonage de l’écran sans pouvoir contrôler le smartphone depuis l'ordinateur. | permet de faire un clonage de l’écran sans pouvoir contrôler le smartphone depuis l'ordinateur. |
| |
| La commande | |
| scrcpy -K | scrcpy -K |
| permet d'utiliser un clavier USB (version de scrcpy >= 1.20) | permet d'utiliser un clavier USB. |
| |
| La commande | |
| scrcpy --record file.mp4 | scrcpy --record file.mp4 |
| permet d'enregistrer l’écran de votre smartphone en l’affichant sur l’écran de l'ordinateur. | permet d'enregistrer l’écran de votre smartphone en l’affichant sur l’écran de l'ordinateur. |
| La commande''scrcpy -N'' s'utilise avec la commande ''scrcpy --record file.mp4'' donc la commande est : | La commande''scrcpy -N'' s'utilise avec la commande ''scrcpy --record file.mp4'' donc la commande est : |
| scrcpy --record file.mp4 -N | scrcpy --record file.mp4 -N |
| Elle enregistre l’écran de votre téléphone sans afficher l’écran du smartphone sur l'ordinateur. | Elle enregistre l'écran de votre téléphone sans afficher l’écran du smartphone sur l'ordinateur. |
| |
| La commande | |
| scrcpy -f | scrcpy -f |
| passe l'écran de téléphone sur votre PC en plein écran. | passe l'écran de téléphone sur votre PC en plein écran. |
| |
| La commande | |
| scrcpy -t | scrcpy -t |
| affiche un point là où le doigt est posé sur l’écran du smartphone. | affiche un point là où le doigt est posé sur l’écran du smartphone. |
| |
| La commande | scrcpy --window-title Nom_De_La_Fenetre |
| scrcpy --window-title Nom_De_L_a_Fenetre | |
| permet de renommer la fenêtre. | permet de renommer la fenêtre. |
| |
| <note>Personnellement j'utilise la commande | |
| scrcpy --window-title Honor8 -S | |
| </note> | |
| |
| ==== Lanceur ==== | ==== Lanceur ==== |
| A l'origine, **scrcpy** ne créait pas de 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. | |
| |
| Il peut être intéressant de créer un lanceur avec l'option de lancement **-w -S** qui n'éteint pas la réplication à chaque fois que l'écran du smartphone se met en veille. Pour créer votre propre lanceur, il vous faut un fichier __texte__ similaire à celui-ci : | À 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. |
| [Desktop Entry] | |
| Version=1.0 | |
| Type=Application | |
| Categories=Utility | |
| Name=Téléphone - scrcpy | |
| Comment=Réplication écran Androïd sur écran PC | |
| Exec=scrcpy -S -w | |
| Icon=android-file-transfer | |
| Path= | |
| Terminal=false | |
| StartupNotify=false | |
| |
| Vous donnez à ce fichier un nom quelconque en **.desktop**, par exemple **scrcpy.desktop**, et vous le placez où vous le souhaitez (mais en toute logique dans **~/.local/share/applications/**, car le .desktop apparaît alors dans votre menu des **accessoires**). Vous pouvez bien sur changer l'icône, le nom, le commentaire, les options de lancement de **scrcpy**, ... | 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]]//.\\ |
| | Vous pouvez bien sûr 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 ==== |
| |
| <note important>Avant de l'utiliser **SANS CÂBLE** (wi-fi) 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. |
| Dans certains cas il faut aller dans paramètres > Système > Options pour les développeurs et activer "**ADB par réseau**". Cette action rend le smartphone vulnérable.</note> | |
| |
| L'utilisation de **Scrcpy** est plus simple avec une connexion via câble USB. Sans câble c'est un peu plus complexe. | 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). |
| |
| Branchez votre smartphone a votre pc via un câble, et ouvrez un terminal. Dans celui-ci, exécutez : | <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> |
| | |
| | Branchez votre smartphone à votre PC via un câble, et ouvrez un terminal. Dans celui-ci, exécutez : |
| adb tcpip 5555 | adb tcpip 5555 |
| cela indiquera au smartphone le port de connexion qui sera utilisé. Bien sûr, 5555 est __un__ port de connexion, que vous pouvez tout à fait changer. | ceci indiquera au smartphone le port de connexion qui sera utilisé. Vous pouvez éventuellement choisir un autre numéro de port que ''5555''. |
| |
| Maintenant il faut récupérer l'**ip** de votre smartphone : allez dans Paramètre > Système (tout en bas) > À propos du téléphone > État > Adresse IP. Notez cette adresse (en IPV4 ou IPV6). | Maintenant il faut récupérer l'**IP** de votre smartphone : allez dans Paramètre > Système (tout en bas) > À propos du téléphone > État > Adresse IP. Notez cette adresse (en IPV4 ou IPV6). |
| |
| Vérifiez que le Wi-Fi est actif sur votre téléphone, et que c'est la même source wi-fi que pour votre PC (votre box, normalement). | Vérifiez que le Wi-Fi est actif sur votre téléphone, et qu'il est connecté au même réseau qu'Ubuntu. |
| |
| Connectez le smartphone avec l'instruction dans le terminal de votre PC : | Connectez le smartphone avec l'instruction dans le terminal de votre PC : |
| adb connect address_ip_smartphone:port | adb connect address_ip_smartphone:port |
| (remplacez **address_ip_smartphone** par la vraie adresse que vous avez notée, et port, par celui défini ci-dessus - par exemple **adb connect 192.168.1.14:5555**) | (remplacez ''address_ip_smartphone'' par la vraie adresse que vous avez notée, et port, par celui défini ci-dessus - par exemple ''adb connect 192.168.1.14:5555'') |
| |
| Vous pouvez maintenant débrancher le câble USB reliant votre smartphone à votre pc. Vérifiez bien que le débogage USB est toujours actif sur le téléphone. | Vous pouvez maintenant débrancher le câble USB reliant votre smartphone à votre PC. Vérifiez bien que le débogage USB est toujours actif sur le téléphone. |
| |
| Vérifions si le téléphone est bien connecté (toujours au terminal de votre PC) : | Vérifions si le téléphone est bien connecté (toujours au terminal de votre PC) : |
| device_ip_address:5555 device | device_ip_address:5555 device |
| |
| C'est bon on peut utiliser scrcpy comme si on avait un câble. | On peut alors lancer **scrcpy** de la même manière qu'avec un câble. |
| <note>Si vous avez des ralentissements ou lags, cela peut venir de la distance avec votre point d’accès WIFI</note> | <note>Si vous rencontrez des ralentissements ou lags, cela peut venir de la distance avec votre point d’accès WIFI, ou de la qualité générale de la connexion.</note> |
| |
| Pour fermer la connexion entre votre smartphone et votre pc il faut juste faire au terminal : | Pour fermer la connexion entre votre smartphone et votre PC : |
| adb kill-server | adb kill-server |
| |
| adb usb | adb usb |
| |
| ===== Problèmes rencontrés ===== | ===== Problèmes courants ===== |
| Pas de connexion : au terminal la commande **scrcpy** renvoie des messages listés ci-dessous : | |
| | Pas de connexion : au terminal la commande ''scrcpy'' renvoie des messages listés ci-dessous : |
| | |
| | ==== Téléphone non détecté ==== |
| |
| **1. Téléphone non détecté** | |
| ERROR: "adb push" returned with value 1 | ERROR: "adb push" returned with value 1 |
| ADB (qu'utilise scrcpy) ne voit pas votre téléphone. Vérifiez avec la commande | ADB (qu'utilise scrcpy) ne voit pas votre téléphone. Vérifiez avec la commande |
| adb devices | adb devices |
| que votre téléphone est vu par ADB. Si ce n'est effectivement pas le cas (la commande ne renvoi rien), il faut trouver la raison : | que votre téléphone est vu par ADB. Si ce n'est effectivement pas le cas (la commande ne renvoi rien), il faut trouver la raison : |
| - le débogage USB est désactivé sur le smartphone (c'est le plus probable). | - le débogage USB est désactivé sur le smartphone. |
| | - Si ce n'est pas cela, changez de câble USB (voir note ci-dessous). |
| - Si ce n'est pas cela, changez le port USB utilisé sur votre PC. | - Si ce n'est pas cela, changez le port USB utilisé sur votre PC. |
| - Si ce n'est pas cela, changez de câble : un problème de câble usagé n'est pas du tout exceptionnel. | |
| |
| **2. Débogage USB non activé** | <note tip> |
| | Les câbles USB vendus dans le commerce sont de qualité très variables, en particulier à partir de la norme USB 3 : peu de câbles possèdent tous les fils nécessaires à tous les cas d'usage, certains ne peuvent même servir qu'à alimenter ou recharger un appareil. |
| | |
| | Les débits maximum (ainsi que la puissance électrique) qu'ils peuvent délivrer varient aussi énormément d'un câble à l'autre. |
| | |
| | Il est malheureusement très courant de s'arracher les cheveux sur ce problème lorsqu'on l'ignore : un mauvais câble, même neuf et en bon état peut complètement empêcher le fonctionnement des outils tels qu'[[wpfr>Android_SDK#Android_Debug_Bridge|ADB]], [[wpfr>Fastboot]], ou **scrcpy**. |
| | </note> |
| | |
| | ==== Débogage USB non activé ==== |
| adb: error: failed to get feature set: no devices/emulators found | adb: error: failed to get feature set: no devices/emulators found |
| l'autorisation **ADB** ("débogage USB") est sans doute à réactiver côté téléphone (ce qui est généralement nécessaire après chaque déconnexion du câble). | l'autorisation **ADB** (//Débogage USB//) est sans doute à réactiver côté téléphone (ce qui est parfois nécessaire après chaque déconnexion du câble). |
| | |
| | ==== Plusieurs téléphones branchés en même temps ==== |
| |
| **3. Plusieurs téléphones branchés en même temps** | |
| adb: error: failed to get feature set: more than one device/emulator | adb: error: failed to get feature set: more than one device/emulator |
| Débranchez le ou les téléphones surnuméraires. | Débranchez le ou les téléphones surnuméraires. |
| Pour en savoir plus, voir la FAQ des problèmes rencontrés : https://github.com/Genymobile/scrcpy/blob/master/FAQ.md#adb-issues | Pour en savoir plus, voir la FAQ des problèmes rencontrés : https://github.com/Genymobile/scrcpy/blob/master/FAQ.md#adb-issues |
| |
| **4. Utilisation sous Wayland** | ==== Utilisation sous Wayland ==== |
| L'utilisation sous [[wayland|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]] | |
| * **(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]] | |
| * [[kdeconnect-kde|Kdeconnect]], un autre logiciel, avec des fonctionnalités similaires. | |
| |
| | * **(//en//)** Le [[https://github.com/Genymobile/scrcpy|GitHub]] de l'application est son seul site officiel. |
| | * **(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. |
| |
| ---- | ---- |
| |
| Contributeur: [[utilisateurs:zaienj|Zaienj]] | //Contributeurs : [[:utilisateurs:Zaienj]], [[:utilisateurs:krodelabestiole]]// |