Différences

Ci-dessous, les différences entre deux révisions de la page.

--- pipewire [Le 15/05/2023, 23:22]
krodelabestiole [Création d'appareils virtuels] typo
+++ pipewire [Le 10/01/2025, 00:05] (Version actuelle)
77.131.3.231 [Mettre en sourdine (mute)]
@@ Ligne 18: / Ligne 18: @@
 ===== Installation =====
-PipeWire est installé par défaut sur Ubuntu à partir de la version [[:kinetic|Kinetic 22.10]]. Vous pouvez [[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>pipewire-jack]]** pour profiter des applications compatibles [[:jackd|JACK]].
+==== Ubuntu 22.04 ====
+PipeWire est installé par défaut sur Ubuntu à partir de la version [[:jammy|Jammy 22.04.4]].
+On ne trouve par contre les paquets **[[apt>pipewire-alsa]]** et **[[apt>pipewire-jack]]** qu'à partir de [[:kinetic|Kinetic 22.10]].\\
+Pour profiter des applications compatibles [[:jackd|JACK]], référez-vous au chapitre suivant :
+==== Ubuntu 20.04 ====
 Sur les versions précédentes il est possible d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>pipewire]]** depuis les dépôts officiels à partir de [[:focal|Focal 20.04]] ([[:depots#sections_universe_et_multiverse_maintenues_par_les_motu|dépôt universe]] pour cette version précise).
 On trouve **[[apt>pipewire-pulse]]** à partir de [[:jammy|Jammy 22.04]] ([[:depots#sections_universe_et_multiverse_maintenues_par_les_motu|dépôt universe]] pour cette version précise).
-On ne trouve les paquets **[[apt>pipewire-alsa]]** et **[[apt>pipewire-jack]]** qu'à partir de [[:kinetic|Kinetic 22.10]].
 Avec [[apt>pipewire-pulse]] et [[apt>pipewire-alsa]], il est conseillé de désinstaller respectivement [[:PulseAudio]] et [[:jackd|JACK]].
+=== Installer le gestionnaire WirePlumber (recommandé) ===
+Le gestionnaire de session par défaut est **pipewire-media-session**, mais il a été rendu obsolète par WirePlumber.
+Pour installer WirePlumber sur ces anciennes versions d'Ubuntu, il faut [[:ppa#ajout_d_un_ppa_a_vos_sources_logicielles|ajouter le PPA]] ''ppa:pipewire-debian/wireplumber-upstream''((https://launchpad.net/~pipewire-debian/+archive/ubuntu/wireplumber-upstream)).
+[[:tutoriel:comment_installer_un_paquet|Installez les paquets]] additionnels de PipeWire : **[[apt>gstreamer1.0-pipewire libpipewire-0.3-{0,dev,modules} libspa-0.2-{bluetooth,dev,jack,modules} pipewire{,-{audio-client-libraries,pulse,bin,jack,alsa,v4l2,libcamera,locales,tests}}]]**.
+Installez le gestionnaire de session **[[apt>wireplumber{,-doc} gir1.2-wp-0.4 libwireplumber-0.4-{0,dev}]]**.
+Maintenant, cachez votre ancien serveur de son PulseAudio.((Voir étape 3a de [[https://github.com/pipewire-debian/pipewire-debian#1-add-the-launchpad-ppa|la documentation officielle]].))
+<note tip>Vous n'avez pas besoin de supprimer PulseAudio pour le remplacer par PipeWire</note>
+<code>
+systemctl --user --now disable pulseaudio.{socket,service}
+systemctl --user mask pulseaudio
+</code>
+Lancer cette commande pour autoriser et lancer PipeWire.((Voir étape 3b de [[https://github.com/pipewire-debian/pipewire-debian#1-add-the-launchpad-ppa|la documentation officielle]].))
+<code>
+systemctl --user --now enable pipewire{,-pulse}.{socket,service} filter-chain
+</code>
+Puisqu'on a choisi WirePlumber comme gestionnaire de session, on doit lancer cette commande
+<code>
+systemctl --user --now enable wireplumber
+</code>
+Vous devriez avoir du son, désormais avec PipeWire + WirePlumber.
+==== Ubuntu 18.04 ====
 <note>Il est aussi possible d'installer PipeWire et tous ses outils sur des versions plus anciennes qui ne les incluent pas dans les dépôts par défaut, à partir d'Ubuntu [[:bionic|Bionic 18.04]].
@@ Ligne 34: / Ligne 70: @@
 Voir ici la documentation en anglais à ce sujet : https://pipewire-debian.github.io/pipewire-debian/</note>
-===== Utilisation =====
+===== Configuration =====
-==== Configuration ====
 Pour une utilisation simple il n'y a rien à configurer. Il suffit de choisir la sortie audio de son choix dans les [[:gnome-control-center|paramètres du système]] ou plus rapidement dans le [[gnome-shell#le_menu_systeme|menu système de la barre supérieure]] (pour [[:GNOME]], à adapter si vous utilisez un autre [[:environnements|environnement de bureau]]).
@@ Ligne 60: / Ligne 94: @@
 {{:captures:qpwgraph_screenshot-1.png?400|}}
+Il n'est pas indispensable d'utiliser cette interface. Les simples connexions sont gérées automatiquement depuis les paramètres de l'[[:environnements|environnement de bureau]] : en choisissant une sortie audio dans le [[:gnome-shell#le_menu_systeme|menu système de GNOME]] par ex., les logiciels du bureau (tels que le navigateur internet ou les lecteurs audio ou vidéo) se connecteront automatiquement au périphérique audio sélectionné. **qpwgraph** peut permettre de visualiser ce comportement.
+Le routage vidéo permet de diriger le ou les flux vidéo de webcams, de cartes d'[[:capture_video|acquisition vidéo]], ou de lecteurs vidéos, vers un ou des logiciel(s) de //streaming// (tel que [[:OBS]]), ou de capture ([[:VJing]] ou enregistrement), ou autres logiciels multimédia en temps réel.
 <note tip>
-Il n'est pas indispensable d'utiliser cette interface. Les simples connexions sont gérées automatiquement depuis les paramètres de l'[[:environnements|environnement de bureau]] : en choisissant une sortie audio dans le [[:gnome-shell#le_menu_systeme|menu système de GNOME]] par ex., les logiciels du bureau (tels que le navigateur internet ou les lecteurs audio ou vidéo) se connecteront automatiquement au périphérique audio sélectionné. qpwgraph peux permettre de visualiser ce comportement.
+On peut aussi visualiser ces connexions actives sans passer par **qpwgraph** au moyen de la commande :
+<code>wpctl status</code>
+Chaque connexion est un "//Stream//" représenté par ''source > destination''.
 </note>
 ==== Gestionnaire de session ====
-Le [[:mao#jack_et_les_gestionnaires_de_session|gestionnaire de session]] pour PipeWire installé par défaut sur Ubuntu est [[https://pipewire.pages.freedesktop.org/wireplumber/|WirePlumber]].
+Le [[:mao#gestionnaires_de_session|gestionnaire de session]] pour PipeWire installé par défaut sur Ubuntu est [[https://pipewire.pages.freedesktop.org/wireplumber/|WirePlumber]].
 Il n'existe pour le moment pas d'interface graphique pour le gérer.
@@ Ligne 103: / Ligne 143: @@
 Ici on crée 2 appareils virtuels, un stéréo, l'autre quadriphonique.
-De la même manière il est possible de créer différents types de //virtual sinks//, par ex. pour diffuser à distance (//streamer//) de l'audio en utilisant différents protocoles réseaux ([[https://github.com/roc-streaming/roc-toolkit|ROC]], [[wpfr>Real-time_Transport_Protocol|RTP]], [[wpfr>AirPlay_(Apple)|AirPlay]], [[:pulseaudio|Pulse]] Tunnel, [[:jackd|JACK]] Tunnel, etc.). Voir la liste des modules disponibles sur la [[https://docs.pipewire.org/page_pipewire_modules.html|documentation officielle]].
+==== Réseau ====
+De la même manière il est possible de créer différents types de //[[#creation_d_appareils_virtuels|virtual sinks]]//, par ex. pour diffuser à distance (//streamer//) de l'audio en utilisant différents protocoles réseaux ([[https://github.com/roc-streaming/roc-toolkit|ROC]], [[wpfr>Real-time_Transport_Protocol|RTP]], [[wpfr>AirPlay_(Apple)|AirPlay]], [[:pulseaudio|Pulse]] Tunnel, [[:jackd|JACK]] Tunnel, etc.). Voir la liste des modules disponibles sur la [[https://docs.pipewire.org/page_pipewire_modules.html|documentation officielle]] et sur le [[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Network|wiki de freedesktop.org]].
+Ceci permet de diffuser le son de votre ordinateur (qu'il s'agisse seulement du son de certaines applications ou de l'intégralité des sons du bureau) sur un appareil distant.
+Grâce à [[:ZeroConf]], PipeWire peut créer automatiquement des //virtual sinks// correspondant à des appareils connectés à votre réseau local. Par ex. pour profiter d'un appareil AirPlay :
+<code>pactl load-module module-raop-discover</code>
+Les appareils compatibles AirPlay visibles devraient alors apparaître comme les interfaces audio ordinaires de votre ordinateur.
+===== Utilisation basique en ligne de commande =====
+On peut pour cela utiliser l'utilitaire WirePlumber (commande ''wpctl'').
+==== Connaître le volume sonore ====
+Volume de la sortie principale :
+<code>
+$ wpctl get-volume @DEFAULT_AUDIO_SINK@
+Volume: 0.85
+</code>
+Volume du micro (entrée principale)
+<code>
+$ wpctl get-volume @DEFAULT_AUDIO_SOURCE@
+Volume: 0.68
+</code>
+==== Fixer le volume ====
+Fixer le volume à 1,25
+<code>
+$ wpctl set-volume @DEFAULT_AUDIO_SINK@ 1.25
+</code>
+Augmenter le volume de 5 % :
+<code>
+$ wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%+
+</code>
+Diminuer le volume de 10 % :
+<code>
+$ wpctl set-volume @DEFAULT_AUDIO_SINK@ 10%-
+</code>
+Augmenter le volume de 6 % sans dépasser 130 % :
+<code>
+$ wpctl set-volume -l 1.3 @DEFAULT_AUDIO_SINK@ 6%+
+</code>
+==== Mettre en sourdine (mute) ====
+Fixer le volume à 0
+<code>
+$ wpctl set-volume @DEFAULT_AUDIO_SINK@ 0
+</code>
+Basculer entre la sourdine et le réglage antérieur. Mettre en sourdine la sortie par défaut lorsque le volume n'est pas nul :
+<code>
+wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle
+</code>
+Rétablir le volume après mise en sourdine (même instruction) :
+<code>
+wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle
+</code>
+Basculer en sourdine la sortie numéro 62 (numéro de sortie obtenu par wpctl status) :
+<code>
+wpctl set-mute 62 toggle
+</code>
+Basculer l'entrée principale (généralement le micro) en sourdine :
+<code>
+wpctl set-mute @DEFAULT_AUDIO_SOURCE@ toggle
+</code>
+Mettre en sourdine la sortie principale pendant une minute :
+<code>
+$ wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle ; sleep 60 ; wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle
+</code>
+===== Problèmes courants =====
+  * Pour savoir quel serveur de son vous utilisez, entrez la commande suivante : <code>pactl info</code>Si le retour indique ''Nom du serveur : PulseAudio (on PipeWire)'', vous utilisez bien PipeWire.
+  * La commande <code>fuser -v /dev/snd/*</code> indique également si on utilise PipeWire et WirePlumber, ou autre serveur de son et [[#gestionnaire de session]].
+  * Pour obtenir des informations sur votre installation audio, vous pouvez aussi [[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>inxi]]** et lancer la commande : <code>inxi -A</code>
+  * La commande <code>systemctl --user status pipewire</code> donnera aussi de nombreuses informations sur l'état du serveur.
+  * La commande <code>wpctl status</code> donne un aperçu général de la configuration audio.\\ Chaque élément audio ou vidéo (matériel ou logiciel) est précédé d'un numéro qu'on peut utiliser comme identifiant (//ID//). On peut utiliser cet //ID// pour obtenir une description détaillée d'un élément précis de la manière suivante : <code>wpctl inspect ID</code>
+  * En cas de problèmes audio comme des craquements, la commande <code>pw-top</code> permet de monitorer les processus audio, la latence de chaque interface, la charge des DSP et les décrochages audio / //[[mao#optimisation_audio|xruns]]// (colonne ''ERR'').((**(//en//)** [[https://docs.pipewire.org/page_man_pw-top_1.html|documentation de
+pw-top]]))
+==== Delay Bluetooth ====
+La connexion [[:bluetooth]] introduit un temps de latence. Quand on regarde des vidéos, la vidéo est généralement retardée de la même durée sans qu'on s'en rende compte, ce qui permet à l'ensemble de rester synchronisé.
+PipeWire permet d'utiliser plusieurs sorties simultanément, dans ce cas on perçoit par contre bien l'écart audio entre une sortie filaire et une sortie bluetooth.\\
+Le seul moyen de synchroniser les 2 signaux est alors de retarder le signal filaire.
+À cette fin on peut trouver des informations au chapitre //Delay// de [[https://docs.pipewire.org/page_module_filter_chain.html#Delay|la documentation]] en anglais.\\
+Une autre possibilité peut-être plus simple (mais plus lourde) est d'ajouter un [[mao#effets|effet]] [[:jackd|JACK]] ou [[:LV2]] qui propose ce genre de chose dans la chaîne audio (un //[[wpfr>Delay_(effet)|delay]]// sans //feedback// et 100% //wet// - sans signal source).
 ===== Voir aussi =====
   * **(en)** [[https://pipewire.org|Site officiel]]
+  * **(en)** [[https://docs.pipewire.org|Documentation officielle]]
+  * **(en)** [[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/home|Wiki PipeWire]] sur [[wpfr>Freedesktop.org]]
   * [[https://linuxmao.org/PipeWire|PipeWire sur Linux MAO]]
+  * de nombreuses informations souvent valables aussi pour Ubuntu (mais en anglais), sur la [[https://wiki.archlinux.org/title/PipeWire|documentation de Arch Linux]]
+  * **(en)** [[https://github.com/mikeroyal/PipeWire-Guide|Guide sur l'écosystème de PipeWire]]
+  * [[https://youtu.be/lTv2jJDcPns|Cette vidéo]] en français explique PipeWire, ALSA, [[:PulseAudio]] et [[:jackd|JACK]]. À noter toutefois que PipeWire est désormais aussi performant que [[:jackd|JACK]] (depuis la sortie de la version 1), et qu'il est lui-même un //[[:services|daemon]]//.
 ----
 //Contributeurs : [[:utilisateurs:krodelabestiole]]//