✎ pipewire [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

{{ :logo:pipewire.png?100| logo de PipeWire}}
====== PipeWire ======

**PipeWire** est le serveur de son installé par défaut sur Ubuntu à partir de la version [[:kinetic|Kinetic 22.10]].

Un serveur de son permet à plusieurs applications d'utiliser simultanément les pilotes de la carte son, afin de pouvoir être toutes audibles et utilisées simultanément.

Il remplace [[:PulseAudio]], le serveur de son installé par défaut jusqu'à [[:jammy|Ubuntu Jammy 22.04]]. Il propose en plus les fonctionnalités avancées utiles dans le domaine de la [[:MAO]] que proposait jusqu'ici le serveur [[:jackd|JACK]], qu'il remplace aussi, avec une configuration simplifiée. Il rend possible l'utilisation simultanée de n'importe lesquels de ses logiciels et appareils audio. On peut par exemple pré-écouter un flux audio sur des oreillettes bluetooth tandis qu'on en diffuse un autre sur la carte son intégrée à son ordinateur, le tout en enregistrant le micro de sa webcam dans [[:Audacity]]...

Il dispose de plus des couches de rétro-compatibilité avec les serveurs de son ALSA, [[:PulseAudio]], et [[:jackd|JACK]].
Pour en bénéficier il faut [[:tutoriel:comment_installer_un_paquet|installer les paquets]] ''[[apt>pipewire-alsa]]'', ''[[apt>pipewire-pulse]]'' et ''[[apt>pipewire-jack]]''. Grâce à ces paquets, les applications compatibles voient respectivement des serveurs ALSA, [[:PulseAudio]], ou [[:jackd|JACK]] tourner, et peuvent s'y connecter. Il s'agit en fait à chaque fois de PipeWire.

PipeWire dispose aussi de fonctionnalités permettant de gérer des flux vidéo, utiles par ex. pour des applications de [[:streaming]].

===== Installation =====

**PipeWire** est installé par défaut sur Ubuntu à partir de la version [[:jammy|Jammy 22.04.4]].\\
Si ce n'est pas le cas, quelle qu'en soit la raison, il suffit d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] ''[[apt>pipewire]]''.

On trouve aussi le paquet ''[[apt>pipewire-pulse]]''(([[:depots#sections_universe_et_multiverse_maintenues_par_les_motu|dépôt universe]] pour [[:jammy|Jammy 22.04]])) qui fournit la rétro-compatibilité pour les applications implémentant [[:PulseAudio]]. Il risque donc d'être indispensable pendant encore un certain temps...

Vous pouvez si besoin installer les paquets ''[[apt>pipewire-jack]]'' pour profiter des applications compatibles [[:jackd|JACK]], et ''[[apt>pipewire-alsa]]'' pour intégrer celles censées se connecter directement au serveur de son d'ALSA.((Ces paquets sont fournis par le [[:depots#sections_universe_et_multiverse_maintenues_par_les_motu|dépôt universe]].))

<note tip>
Avec ''[[apt>pipewire-pulse]]'' et ''[[apt>pipewire-jack]]'', il est conseillé de [[:tutoriel:comment_supprimer_un_paquet|désinstaller]] respectivement [[:PulseAudio]] (paquet ''pulseaudio'') et [[:jackd|JACK]] (paquet ''jackd''), qui deviennent inutiles, et peuvent être gênants.
</note>

C'est le gestionnaire de session **WirePlumber** qui est installé par défaut sur ces versions récentes.

==== Snap ====

**PipeWire** est aussi disponible en [[:snap]] depuis [[https://snapcraft.io/pipewire|Snapcraft]], avec ''wireplumber'' et ''pipewire-pulse''.

On peut donc l'installer sur Ubuntu simplement en installant ''pipewire'' depuis le [[:snap store|centre d'applications (Snap Store)]], ou en ligne de commande :
<code>snap install pipewire</code>

==== Focal 20.04 ====

Sur ces versions plus anciennes 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).

=== Installer le gestionnaire WirePlumber (recommandé) ===

Le gestionnaire de session par défaut sur [[:focal|Focal 20.04]] est **[[https://gitlab.freedesktop.org/pipewire/media-session|PipeWire Media Session]]** (paquet ''[[apt>pipewire-media-session]]''), mais il a été rendu obsolète par **[[https://gitlab.freedesktop.org/pipewire/wireplumber|WirePlumber]]**(([[https://linuxmao.org/WirePlumber|WirePlumber sur Linux MAO]], [[https://pipewire.pages.freedesktop.org/wireplumber/|documentation officielle]])), installé par défaut sur les versions plus récentes d'Ubuntu.

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>Il n'est pas indispensable de supprimer **PulseAudio** pour le remplacer par **PipeWire**.</note>

<code>
systemctl --user --now disable pulseaudio.{socket,service}
systemctl --user mask pulseaudio
</code>

Lancez 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 le serveur **PipeWire** et le gestionnaire **WirePlumber**.

==== Bionic 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]].

Il faut pour cela [[:ppa#ajout_d_un_ppa_a_vos_sources_logicielles|ajouter les PPA]] **ppa:pipewire-debian/pipewire-upstream**((https://launchpad.net/~pipewire-debian/+archive/ubuntu/pipewire-upstream)) et **ppa:pipewire-debian/wireplumber-upstream**((https://launchpad.net/~pipewire-debian/+archive/ubuntu/wireplumber-upstream)) dans vos sources de logiciels.

Voir ici la documentation en anglais à ce sujet : https://pipewire-debian.github.io/pipewire-debian/</note>

===== 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]]).

Pour voir la liste des actions disponibles en [[:commande_shell|ligne de commande]] :
<code>pw-cli help</code>

Pour voir la liste des logiciels et appareils disponibles (via [[#gestionnaire_de_session|WirePlumber]]) :
<code>wpctl status</code>

**PipeWire** et **Wireplumber** se paramètrent nativement à l'aide de fichiers de configuration situés dans les répertoires ''/etc/pipewire'' et ''/usr/share/wireplumber'', qu'il est possible de surcharger avec des réglages personnalisés dans son répertoire personnel, respectivement ''~/.config/pipewire'' et ''~/.local/share/wireplumber''.

Il est aussi possible d'accéder à certains paramètres depuis des interfaces graphiques.

==== Interfaces graphiques ====

Il existe différentes interfaces graphiques permettant de gérer **PipeWire** :
  * en particulier **[[https://github.com/dimtpap/coppwr|coppwr]]** fournit un accès à quantité d'informations et de réglages de bas niveau. Il propose entre autre un //graph// pour configurer le [[#routage]]. **coppwr** est  disponible en [[:flatpak]] sur le dépôt [[https://flathub.org/apps/io.github.dimtpap.coppwr|Flathub]] et peut donc s'installer en suivant [[:tutoriel:installer_application_flatpak|cette procédure]] puis en installant le paquet ''io.github.dimtpap.coppwr''.
  * **[[https://github.com/rncbc/qpwgraph|qpwgraph]]** est probablement l'interface la plus utilisée pour [[#router]] les signaux audio, vidéo et [[:MIDI]] (utilise la bibliothèque [[:Qt]]).
  * **[[https://gitlab.freedesktop.org/pipewire/helvum|Helvum]]** est une alternative à **qpwgraph**, également consacrée au [[#routage]], utilisant la bibliothèque [[:GTK]].

==== Routage ====

En plus d'utiliser simultanément plusieurs logiciels et interfaces matérielles, PipeWire permet de les relier ensemble dans n'importe quel sens, à la manière d'un studio virtuel.

On peut gérer ces connexions en ligne de commande mais il est probablement beaucoup plus pratique d'utiliser une [[#interfaces graphiques|interface graphique]], telle que [[https://gitlab.freedesktop.org/rncbc/qpwgraph|qpwgraph]], qui remplace avantageusement [[:QjackCtl]] (qu'on utilisait pour [[:jackd|JACK]]).

**qpwgraph** est disponible depuis les dépots officiels : ''[[apt>qpwgraph]]'' ou en [[https://flathub.org/apps/details/org.rncbc.qpwgraph|Flatpak]].

Chaque élément (matériel ou logiciel) apparaît comme un bloc avec ses entrées à gauche et ses sorties à droite. On peut les relier les unes aux autres en tirant des liens par cliquer-glisser. Les liens peuvent ainsi conduire des signaux d'un logiciel ou d'un périphérique à l'autre. Des signaux :
  * audio (en vert)
  * [[:MIDI]] (en rose : MIDI ALSA, ou rouge : MIDI JACK - voir [[:midi#implementation_du_midi_sous_linux|Implémentation du MIDI sous Linux]])
  * ou vidéo (en bleu)

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

==== Optimisation ====

En [[:MAO]], on a souvent besoin de jouer le son //en temps réel//. Malheureusement le matériel électronique et les ordinateurs en particulier introduisent un problème qu'on appelle le //**temps de latence**// : il s'agit du délai qui apparaît entre le moment où on demande à la machine de reproduire un son (en appuyant sur une touche d'un clavier par exemple), et celui où le son sort effectivement des haut-parleurs.\\
Il est souvent court (on l'exprime en millisecondes), mais si on peut négliger ce délai lorsqu'on appuie sur une touche play, le problème devient beaucoup plus épineux pour jouer de la batterie électronique ou pour appliquer un effet sur sa voix sans s'entendre en double.

Diverses optimisations permettent de le réduire au maximum. La plus importante optimisation consiste à ajuster le //buffer// (taille du tampon) et le //sample rate// (fréquence d'échantillonnage). À ce sujet, voir //[[:mao#optimisation audio]]// sur la page //[[:MAO]]//.((Voir aussi la [[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-PipeWire#samplerate-settings|documentation officielle]].))
<code>
pw-metadata -n settings 0 clock.force-rate <samplerate>
pw-metadata -n settings 0 clock.force-quantum <buffersize>
</code>
  * Remplacer ''<samplerate>'' par la fréquence d’échantillonnage désirée. Plus cette taille est élevée meilleure est la qualité, plus court est la latence, mais plus haute est la consommation CPU. Les interfaces audio utilisent généralement des fréquences de 41000Hz, 48000Hz, ou 96000Hz.((Sachant que l'oreille humaine n'entend pas de fréquence supérieure à 20000Hz.))
  * Remplacer ''<buffersize>'' par la taille de tampon (en nombre de //samples//). Cette valeur doit être une puissance de 2.
''quantum'' correspond ici à la taille de tampon (qu'on appelle généralement plutôt //buffer//).
<note>Pour les cartes sons USB, certaines combinaisons de framerate / buffer sont préférables à d'autres : voir sur [[https://wiki.linuxaudio.org/wiki/list_of_jack_frame_period_settings_ideal_for_usb_interface|cette page]] //(en)// les combinaisons indiquées en gras.</note>

Par exemple, pour une fréquence d’échantillonnage de 48000Hz et un tampon de 256 samples :
<code>
pw-metadata -n settings 0 clock.force-rate 48000
pw-metadata -n settings 0 clock.force-quantum 256
</code>

Pour vérifier les réglages :
<code>
pw-metadata -n settings
</code>

Pour réinitialiser les paramètres par défaut :
<code>
pw-metadata -n settings 0 clock.force-rate 0
pw-metadata -n settings 0 clock.force-quantum 0
</code>

==== Gestionnaire de session ====

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.

On peut le contrôler avec la commande ''wpctl'' et ses fichiers de configuration se trouvent sous ''/usr/share/wireplumber''.

==== Création d'appareils virtuels ====

Il peut être utile de créer un appareil virtuel (//virtual sink//) pour par ex. faciliter le routage entre les différentes applications.

Pour cela créez un fichier ''~/.config/pipewire/pipewire.conf.d/10-null-sink.conf'' contenant par ex. :

<file conf 10-null-sink.conf>context.objects = [
    {   factory = adapter
        args = {
           factory.name     = support.null-audio-sink
           node.name        = "Virtual Stereo"
           media.class      = Audio/Sink
           object.linger    = true
           audio.position   = [ FL FR ]
           monitor.channel-volumes = true
        }
    }
    {   factory = adapter
        args = {
           factory.name     = support.null-audio-sink
           node.name        = "Virtual Quadri"
           media.class      = Audio/Sink
           object.linger    = true
           audio.position   = [ FL FR RL RR ]
           monitor.channel-volumes = true
        }
    }
]</file>
Ici on crée 2 appareils virtuels, un stéréo, l'autre quadriphonique.

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

La commande ''wpctl get-volume'' retourne une valeur numérique décimale. 0 est muet et 1 correspond au volume à 100%. Le volume peut être supérieur à 100% (par contre il a dans ce cas toutes les chances de saturer).

* Volume de la sortie principale :<code>wpctl get-volume @DEFAULT_AUDIO_SINK@</code>

* Volume du micro (entrée principale) :<code>wpctl get-volume @DEFAULT_AUDIO_SOURCE@</code>

Ces commandes retournent par exemple ''Volume: 0.85''.

==== Régler le volume ====

C'est la commande ''wpctl set-volume'' qui permet de définir le volume. On peut l'exprimer en nombre décimal ''1.0'' ou en pourcentage ''100%'', et en absolu ou relativement au volume actuel grâce aux signes ''+'' ou ''-''.

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

La commande ''wpctl set-mute'' permet aussi bien d'activer que de désactiver la sourdine.

* 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 ou rétablir le volume après mise en sourdine :<code>wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle</code>

* Basculer la sourdine sur la sortie numéro ''62'' (numéro de sortie obtenu grâce à ''wpctl status'') :<code>wpctl set-mute 62 toggle</code>

* Basculer la sourdine sur l'entrée principale (généralement le micro) :<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://pipewire.pages.freedesktop.org/wireplumber/design/understanding_session_management.html|Documentation de WirePlumber]]
  * **(//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]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : P T G S V Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported