{{tag>Logiciel}}

====== Scrcpy : Afficher et contrôler des appareils Android sous Ubuntu ======

Le logiciel open source **Scrcpy** affiche et contrôle sur son ordinateur les appareils Android connectés en USB (ou via TCPIP).

Il ne nécessite aucun accès root et fonctionne sous GNU/Linux, Windows et macOS.

{{ https://raw.githubusercontent.com/Genymobile/scrcpy/master/assets/screenshot-debian-600.jpg?400 }}

Il est axé sur :
  * **légèreté** (n'affiche que l'écran de l'appareil)
  * **performance** (30~60fps)
  * **qualité** (1920×1080 ou plus)
  * **faible latence** (35~70ms)
  * **faible temps de démarrage** (~1 seconde pour afficher la première image)
  * **non intrusif** (rien n'est installé sur l'appareil)


FIXME A tester : adb donne un message d'erreur...

===== Pré-requis =====

  * Vérifiez que votre appareil est connecté en exécutant <cli prompt='$ '>...@...:~ $ adb devices</cli> depuis le répertoire android_sdk/platform-tools/. Si votre téléphone est connecté, vous verrez son nom apparaître sous la forme "device".
  * Note : un dialogue vous demande si vous acceptez la clé RSA qui permet le débogage par cet ordinateur. Ce mécanisme de sécurité veille à ce que le débogage USB et les autres commandes adb ne puissent être exécutés que si vous pouvez déverrouiller l'appareil et accuser réception de la boîte de dialogue.
  * Pour plus d'informations sur la connexion à un téléphone via USB, lisez [[https://developer.android.com/studio/run/device|Run Apps on a Hardware Device]].

  * Sur certains appareils, vous devez également activer [[https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323|une option supplémentaire]] pour le contrôler à l'aide du clavier et de la souris.

  * Un **câble** permettant de relier le smartphone a l'ordinateur.

===== Installation =====

<WRAP list-deep>
  - **Mettez votre smartphone en mode adb**
    - **Connectez votre téléphone au PC** avec un câble USB
    - **Sur le smartphone**, allez dans les **Paramètres**, menu **Système** :{{ :logiciel:android:scrcpy:scrcpy-01.png?200 |}}
    - **Options pour les développeurs** :{{ :logiciel:android:scrcpy:scrcpy-02.png?200 |}}
    - **Activez le mode debug** :{{ :logiciel:android:scrcpy:scrcpy-03.png?200 |}}Les options du développeur sont masquées par défaut. Pour les rendre visibles, allez dans **Paramètres -> À propos du téléphone** et appuyez sept fois sur **Numéro de build**.
  - **Sur votre PC** (sous ubuntu) :
    - **Installez [[apt>adb,scrcpy]]**<cli prompt='$ '>...@...:~$ sudo apt install {adb,scrcpy}</cli>Vous pouvez aussi installer le snap scrcpy
</WRAP>

<WRAP center round tip 60%>
**Sous Windows**, téléchargez et installez l'archive pré-construite avec toutes les dépendances (y compris adb) :[[https://github.com/Genymobile/scrcpy/releases/download/v1.17/scrcpy-win64-v1.17.zip]]
</WRAP>

===== Configuration =====

<WRAP list-deep>
  - **Configuration de la capture**
    - **Réduire les dimensions** : pour limiter la largeur et la hauteur (par exemple 1024), <cli prompt='$ '>...@...:~ $ scrcpy --max-size 1024</cli>ou<cli prompt='$ '>...@...:~ $ scrcpy -m 1024  # short version</cli>L'autre dimension est calculée pour que le rapport hauteur/largeur soit préservé. Ainsi, un appareil en 1920×1080 sera reflété en 1024×576.
    - **Changer de débit** : le débit par défaut est de 8 Mbps ; par exemple, pour le modifier à 2 Mbps :<cli prompt='$ '>...@...:~ $ scrcpy --bit-rate 2M</cli>ou<cli prompt='$ '>...@...:~ $ scrcpy -b 2M  # short version</cli>
    - **Limiter la fréquence d'images** :<cli prompt='$ '>...@...:~ $ scrcpy --max-fps 15</cli>
    - **redimensionnement** : par ex. 1224x1440 avec décalage (0,0) :<cli prompt='$ '>...@...:~ $ scrcpy --crop 1224:1440:0:0</cli>Si --max-size est également spécifié, le redimensionnement est appliqué après le recadrage.
    - **Verrouiller l'orientation de la vidéo** :
      * **orientation naturelle** :<cli prompt='$ '>...@...:~ $ scrcpy --lock-video-orientation 0</cli>
      * **sens antihoraire** :<cli prompt='$ '>...@...:~ $ scrcpy --lock-video-orientation 1</cli>
      * **180°** :<cli prompt='$ '>...@...:~ $ scrcpy --lock-video-orientation 2</cli>
      * **90° dans le sens horaire** :<cli prompt='$ '>...@...:~ $ scrcpy --lock-video-orientation 3</cli>Cela affecte l'orientation de l'enregistrement.
</WRAP>


===== Utilisation =====

==== Avec câble USB ====

  - Votre smartphone étant connecté en USB à votre pc,
  - ouvrez un terminal sur le PC et exécutez la commande<cli prompt='$ '>...@...:~ $ scrcpy</cli>{{ :logiciel:android:scrcpy:scrcpy-04.png?200 |}}
  - Pour afficher les nombreuses fonctionnalités :<cli prompt='$ '>...@...:~ $ scrcpy --help</cli>

==== Sans câble USB ====

<WRAP center round important 60%>
On suppose que tout fonctionne déjà avec un câble USB.
</WRAP>
FIXME Cela ne marche pas s'il n'y a pas d'accès Wi-Fi

  - **Connectez votre smartphone à votre PC par un câble USB**
  - Sur le PC, **attribuez un port de connexion au smartphone** (ici, 5555):<cli prompt='$ '>...@...:~ $ adb tcpip 5555
restarting in TCP mode port: 5555</cli>
  - **Débranchez le câble USB.**
  - **Récupérez l'IP de votre smartphone** :
    - Allez dans **Paramètres -> Système** :{{ :logiciel:android:scrcpy:scrcpy-01.png?200 |}}
    - Cliquez sur **À propos du téléphone** :{{ :logiciel:android:scrcpy:scrcpy-05.png?200 |}}
    - puis sur **État** :{{ :logiciel:android:scrcpy:scrcpy-06.png?200 |}}
    - et **lisez l'adresse IP** :{{ :logiciel:android:scrcpy:scrcpy-07.png?200 |}}
  - **Connectez le smartphone** avec cette adresse IP :<cli prompt='$ '>...@...:~ $ adb connect address_ip_smartphone</cli>FIXME Cela ne marche pas s'il n'y a pas d'accès Wi-Fi
  - **Vérifiez qu'il est connecté** :<cli prompt='$ '>...@...:~$ adb devices
List of devices attached
device_ip_address:5555 device</cli>C'est bon, on peut utiliser scrcpy comme si on avait un câble.

Pour fermer la connexion entre votre smartphone et votre pc, lancez :<cli prompt='$ '>...@...:~$ adb kill-server</cli>

==== Enregistrement ====

==== Connexion ====

==== Configuration de la fenêtre ====

==== Autres options de miroir ====

==== Contrôle des entrées ====

==== Dépôt de fichiers ====

==== Transmission du son ====

===== Raccourcis =====

===== Chemins personnalisés =====


==== Sans câble ====

==== Commandes ====

  * <cli prompt='$ '>...@...:~$ scrcpy --always-on-top</cli>met la fenêtre au premier plan.
  * <cli prompt='$ '>...@...:~$ scrcpy -n</cli> fait un clonage de l’écran sans pouvoir contrôler le smartphone depuis l'ordinateur.
  * <cli prompt='$ '>...@...:~$ scrcpy --record file.mp4</cli>enregistre l’écran du smartphone en l’affichant sur l’écran de l'ordinateur.
  * <cli prompt='$ '>...@...:~$ scrcpy --record file.mp4 -N</cli>enregistre l’écran du smartphone sans l’afficher sur l’écran de l'ordinateur.
  * <cli prompt='$ '>...@...:~$ scrcpy -S</cli>éteint l’écran du smartphone mais continue la diffusion sur l'ordinateur.
  * <cli prompt='$ '>...@...:~$ scrcpy -t</cli>affiche un point là où le doigt est posé sur l’écran du smartphone.
  * <cli prompt='$ '>...@...:~$ scrcpy --window-title Nom_De_L_a_Fenetre</cli>permet de renommer la fenêtre.

Personnellement j'utilise la commande :<cli prompt='$ '>...@...:~$ scrcpy --window-title Honor8 -S</cli>

==== Raccourcis ====

  ; <key>C+H</key>
  : retour menu
  ; <key>C+B</key>
  : retour en arrière
  ; <key>C+'S'</key>
  : va dans le multi-tache
  ; Clic gauche
  : Allume le smartphone
  ; <key>C+P</key>
  : Allume/Éteint le smartphone.
  ; <key>C+O</key>
  : Éteint l’écran du smartphone
  ; <key>C+R</key>
  : Tourne l’écran si possible
  ; <key>C+N</key>
  : Ouvre le panel de notification
  ; <key>C+S+N</key>
  : Ferme le panel de notification

==== FAQ ====

===== Désinstallation =====

===== Voir aussi =====

  * **(fr)** [[https://doc.ubuntu-fr.org/scrcpy]]
  * **(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]]
  * **(fr)** [[https://linuxfr.org/users/rom1v/journaux/scrcpy-une-appli-pour-afficher-et-controler-des-devices-android]]
  * **(en)** [[https://github.com/Genymobile/scrcpy]]
  * **(en)** [[https://blog.rom1v.com/2018/03/introducing-scrcpy/]]
  * **(en)** [[https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/]]

----
//Basé sur << [[https://doc.ubuntu-fr.org/scrcpy|Scrcpy]] >> par Documentation ubuntu-fr.//