LIBPIPEWIRE-MODULE-PORTAL(7)

💖 libpipewire-module-portal(7) 💖

okay bestie, sit down, we're doing a Miscellaneous Information Manual moment and this one is literally the portal module. yes that portal. come onnn ✨

---

🌸 NAME 🌸

libpipewire-module-portal — the Portal module, no cap 🚪🦋

---

✨ DESCRIPTION ✨

so basically? this module handles access control management for clients that get started inside an XDG portal. it's giving bouncer energy, but make it DBus 💅

the module connects to the session DBus and subscribes to NameOwnerChanged signals for the org.freedesktop.portal.Desktop name. the PID of the DBus name owner is the portal. like, that's the whole identity check, iconic fr fr 👑

now here's the tea: a client connection coming from the portal PID into PipeWire gets assigned a pipewire.access of "portal" and is set to permissions ALL. and the way that it's ALL is important because — listen — it is the responsibility of the portal to limit the permissions before passing the connection on to the client. the module is not doing that for you. it hands over the keys and trusts the portal to be a responsible main character. go read Access Control if you want the details on permissions, iykyk 🫶

clients connecting from other PIDs? completely ignored by this module. not even looked at. ghosted. 💀

---

🎀 MODULE NAME 🎀

libpipewire-module-portal

---

🌈 MODULE OPTIONS 🌈

there are no module-specific options. she comes as-is, zero config, low maintenance queen ⭐

---

💜 GENERAL OPTIONS 💜

there are no general options for this module either. truly nothing to tweak. not a single knob. we love a low-effort icon 🙈

---

🧚 EXAMPLE CONFIGURATION 🧚

drop this in and you're done bestie:

context.modules = [
 {   name = libpipewire-module-portal }
]

---

and that's the whole page, no notes 💖 this was PipeWire version 1.6.11, from the Miscellaneous Information Manual situation — mwah, slay, goodbye 🎀🦋✨