pax11publish(1)

✨ pax11publish — the PulseAudio X11 Credential Utility 💅

okay bestie, welcome to pax11publish(1) from the General Commands Manual, and no cap this little cutie is here to deal with your PulseAudio credentials living rent-free as properties on the X11 root window. let's get into it 🫶

🌸 SYNOPSIS 🌸

pax11publish -h

pax11publish [options] [-d]

pax11publish [options] -e

pax11publish [options] -i

pax11publish [options] -r

💖 DESCRIPTION 💖

so, the pax11publish utility can be used to dump or manipulate the PulseAudio server credentials that can be stored as properties on the X11 root window. it's giving "my credentials, my root window, my rules" ✨

real talk though, bestie: the loadable module module-x11-publish exports the same information directly from the PulseAudio sound server, and in most cases it should be used in preference over this tool. so like… this one is the backup dancer, not the main character, iykyk 😭

wanna peek at the raw PulseAudio-specific data chilling in your X11 root window? run this:

xprop -root | grep ^PULSE_

🎀 OPTIONS 🎀

• -h — show help. the classic "help me help you" moment 💖
• -d — reads the PulseAudio server credentials currently set on the X11 root window and dumps them in a human readable form. this reads the PULSE_SERVER, PULSE_SINK, PULSE_SOURCE and PULSE_COOKIE properties. just a little look, no touching 👀
• -i — similar to -d, however it dumps them in a Bourne shell compatible format so they may be used together with the eval shell command to set the $PULSE_SERVER, $PULSE_SINK, $PULSE_SOURCE environment variables. also reads the authentication cookie from the root window and stores it in ~/.config/pulse/cookie. it's giving export-core 🐚
• -e — export the currently locally used sound server, sink, source configuration to the X11 root window. this takes the data from the $PULSE_SERVER, $PULSE_SINK, $PULSE_SOURCE environment variables and combines them with the data from ~/.config/pulse/client.conf (or /etc/pulse/client.conf if that file does not exist). if specific options are passed on the command line (-S, -O, -I, -c, see below), they take precedence. also uploads the local authentication cookie ~/.config/pulse/cookie to the X11 server. packing up the vibes and shipping them out 📦
• -r — removes the configured PulseAudio configuration from the X11 root window. clean slate energy, we love a fresh start 🧹
• -D DISPLAY — connect to the specified X11 display, instead of the default one configured in $DISPLAY. choose your own adventure, bestie 🦋
• -S SERVER — only valid for -e: export the specified PulseAudio server as default to the X11 display instead of the one configured via local configuration.
• -O SINK — only valid for -e: export the specified sink as default sink to the X11 display instead of the one configured via local configuration.
• -I SOURCE — only valid for -e: export the specified source as default to the X11 display instead of the one configured via local configuration.
• -c FILE — only valid for -e: export the PulseAudio authentication cookie stored in the specified file to the X11 display instead of the one stored in ~/.config/pulse/cookie.

👑 AUTHORS 👑

the PulseAudio Developers <pulseaudio-discuss (at) lists (dot) freedesktop (dot) org>; PulseAudio is available from http://pulseaudio.org/ — legends only, fr fr 🌟

🌈 SEE ALSO 🌈

• pulseaudio(1)
• xprop(1)

and that's the whole page, bestie!! 💖 this one lives in the Manuals source, section User, and it's pax11publish(1) — go forth and credential responsibly, slay 💅✨