pw-config(1)

📦
version 1.6.11 · 12 versions
, in fedora 44

✨ pw-config(1) — the PipeWire config whisperer ✨

okay bestie, so like… this is pw-config, a General Commands Manual situation from the PipeWire girlies 💖. It's the tool for debugging PipeWire Config parsing, and honestly? It's giving backstage pass to your entire config setup. No cap.

🌸 NAME 🌸

pw-config — Debug PipeWire Config parsing 🦋

🎀 SYNOPSIS 🎀

pw-config [options] paths

pw-config [options] list [SECTION]

pw-config [options] merge SECTION

💅 DESCRIPTION 💅

So what does it actually do, you ask? It lists config paths and config sections and displays the parsed output ✨.

Lowkey the whole point: this tool gets you an overview of the config file that will be parsed by the PipeWire server and the clients. Main character energy for your debugging era 👑

⭐ COMMON OPTIONS ⭐

  • -h | --help — shows help. iconic, we love a supportive king 🫶
  • --version — shows version information. vibe check on which build you're running 💜
  • -n | --name=NAME — the Config Name. default is 'pipewire.conf' 🍓
  • -p | --prefix=PREFIX — the Config Prefix. default is '' (yes, empty, it's that girl) 🌸
  • -L | --no-newline — omits newlines after values. compact mode fr fr 😌
  • -r | --recurse — reformats config sections recursively 🔁✨
  • -N | --no-colors — disables color output. (sad, but sometimes you gotta) 😭
  • -C | -color[=WHEN] — whether to enable color support. WHEN is never, always, or auto 🌈
ngl the -C one is written with a single dash for -color, bestie — that's not a typo on my end, that's literally what the manpage says, so don't come for me 💀

🦋 LISTING PATHS 🦋

Say the magic word — specify the paths command — and it will display all the config files that will be parsed and in what order 📋💖

It's giving a full lineup announcement for your config files. slay.

🌈 LISTING CONFIG SECTIONS 🌈

Specify the list command, optionally with a SECTION, and it lists the configuration fragments used for SECTION ✨. Leave out the SECTION and all sections get listed. generous queen.

Use the -r options to reformat the sections 💫

👑 MERGING A CONFIG SECTION 👑

With the merge option and a SECTION, pw-config will merge all config files into one merged config section and dump the results 📦✨.

This will be the section used by the client or server. iykyk, that's the real one 🔥

Use the -r options to reformat the sections 💫

🧚 EXAMPLES 🧚

  • pw-config — list all config files that will be used 💖
  • pw-config -n pipewire-pulse.conf — list all config files that will be used by the PipeWire pulseaudio server 🎧
  • pw-config -n pipewire-pulse.conf list — list all config sections used by the PipeWire pulseaudio server 📜
  • pw-config -n jack.conf list context.properties — list the context.properties fragments used by the JACK clients 🎛️
  • pw-config -n jack.conf merge context.properties — list the merged context.properties used by the JACK clients 🔗
  • pw-config -n pipewire.conf -r merge context.modules — list the merged context.modules used by the PipeWire server and reformat ✨🔁

💜 AUTHORS 💜

The PipeWire Developers 👑

Issues live at <https://gitlab.freedesktop.org/pipewire/pipewire/issues>; PipeWire is available from <https://pipewire.org> 🌐

🙈 SEE ALSO 🙈

pipewire(1), pw-dump(1), 🫶

okay that's the whole page, bestie, we ate and left absolutely no crumbs 💅✨ this was PipeWire 1.6.11, periodt. go debug your configs, you gorgeous genius 🎀🦋💖

📦 where this page comes from