Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.
Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement…
Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
{{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 =====

  ~~ol:hierarchical~~
  - **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 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 =====

  ~~ol:hierarchical~~
  - **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.


===== 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>

  - **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
==== 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 ====

<WRAP center round tip 60%>
Avant de l'utiliser SANS CÂBLE essayez avec un câble pour voir si tout fonctionne correctement
</WRAP>

Pour utiliser Scrcpy sans câble, c'est déjà plus complexe.

  - Branchez votre smartphone à votre pc.
  - Lancez :<cli prompt='$ '>...@...:~$ adb tcpip 5555</cli>Cela donne le port de connexion au smartphone. Bien sûr 5555 est le port de connexion mais vous pouvez bien évidement le changer.
  - Débranchez le câble reliant votre smartphone à votre pc.
  - Pour récupérer l'ip de votre smartphone, allez dans **Paramètre > À propos (tout en bas) > État > Adresse IP**
  - Connectez le smartphone en lançant : <cli prompt='$ '>...@...:~$ adb connect addresse_ip_smartphone</cli>
  - Vérifiez qu'il est connecté :<cli prompt='$ '>...@...:~$ adb devices</cli>Le retour devrait être : <cli prompt='$ '>...@...:~$ 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>

==== 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.//
Piste : • sync : synchroniser des dokuwikis • edittable : édition de tableaux dans Dokuwiki • Shutter : capture d'écran • Apache sur RaspBerry Pi : un serveur Web (LAMP) • Un serveur NAS sur un Raspberry Pi : partager un disque ou une clé USB sur le réseau • extlist : syntaxe étendue pour les listes • Dokuwiki : un wiki opensource sans base de données • LAMP : un serveur HTTP sous Linux, Apache 2, MySQL et PHP • DNSMasq : Utilisation du plug-in DNSMasq de NetworkManager
Documentation du Dr FRAPPE

Recherche

Navigation

Imprimer/exporter

Outils
