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

====== 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 =====
==== Ubuntu 22.10 ou supérieure ====
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]].

On ne trouve les paquets **[[apt>pipewire-alsa]]** et **[[apt>pipewire-jack]]** qu'à partir de [[:kinetic|Kinetic 22.10]].

==== Ubuntu 20.04 et 22.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).

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**, un autre gestionnaire de session du son est disponible et est intensivement recommandé car il serait plus performant et aurait plus de fonctionnalité.

<code>
sudo add-apt-repository ppa:pipewire-debian/wireplumber-upstream

sudo apt-get update
</code>

Installez les paquets additionnels de pipewire
<code>
sudo apt install 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}}
</code>

Installez le gestionnaire de session
<code>
sudo apt-get install wireplumber{,-doc} gir1.2-wp-0.4 libwireplumber-0.4-{0,dev}
</code>

Maintenant, cachez pulseaudio (votre ancien gestionnaire)((source: [[https://github.com/pipewire-debian/pipewire-debian#1-add-the-launchpad-ppa|étape 3a documentation]]))
<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((source: étape 3b de la documentation)).
<code>
systemctl --user --now enable pipewire{,-pulse}.{socket,service} filter-chain.service
</code>

Puisqu'on a choisi WirePlumber comme gestionnaire de session, on doit lancer cette commande
<code>
systemctl --user --now enable wireplumber.service
</code>

Vous devriez avoir du son, désormais avec PipeWire + WirePlumber

//Voir [[https://github.com/pipewire-debian/pipewire-debian#1-add-the-launchpad-ppa|la documentation sur la forge officielle]]//

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

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>

==== 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 utiliser une 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)

<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** peut permettre de visualiser ce comportement.
</note>

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.

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

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.

===== Problèmes courants =====

Tout d'abord, pour savoir quel serveur de son vous utilisez, entrez la commande suivante :

pactl info

Si le retour indique ''Nom du serveur : PulseAudio (on PipeWire)'', vous utilisez bien PipeWire.

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 :

inxi -A

La commande

systemctl --user status pipewire
donnera aussi de nombreuses informations sur l'état du serveur.

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

* **(en)** [[https://pipewire.org|Site officiel]]
  * [[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]]

----
//Contributeurs : [[:utilisateurs:krodelabestiole]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : C H P D S 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