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

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

<subnumberlist>
  - **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.//
Piste : • PostGreSQL sur un Raspberry Pi : une base de données SQL • cli : plugin Command Line Interface pour Dokuwiki • Cloud : espace disque sur internet • Adminer : une interface web pour gérer les BDD SQL • Bash : la ligne de commande sous Linux • Scrcpy : Afficher et contrôler des appareils Android sous Ubuntu • Flatpak, un format de paquets universel
Documentation du Dr FRAPPE

Recherche

Navigation

Imprimer/exporter

Outils
