--- title: From Lua to JSON: refactoring WirePlumber's... description: WirePlumber's upcoming 0.5 release replaces Lua-based configuration with a JSON syntax (SPA JSON) inherited from PipeWire. The new system distributes settings... canonical: https://daily.dev/posts/from-lua-to-json-refactoring-wireplumber-s-configuration-system-6m9sxjw6i twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: From Lua to JSON: refactoring WirePlumber's configuration system | daily.dev og:description: WirePlumber's upcoming 0.5 release replaces Lua-based configuration with a JSON syntax (SPA JSON) inherited from PipeWire. The new system distributes settings... og:url: https://daily.dev/posts/from-lua-to-json-refactoring-wireplumber-s-configuration-system-6m9sxjw6i og:image: https://api.daily.dev/og/posts/6M9sXJw6I.png og:image:alt: From Lua to JSON: refactoring WirePlumber's configuration system og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # From Lua to JSON: refactoring WirePlumber's configuration system **[Collabora Blog](https://daily.dev/sources/collabora)** · 10 min read · 0 upvotes · 0 comments ## Summary WirePlumber's upcoming 0.5 release replaces Lua-based configuration with a JSON syntax (SPA JSON) inherited from PipeWire. The new system distributes settings across modular .conf files under wireplumber.conf.d/, enables runtime setting changes via pw-metadata without restarts, supports per-setting user overrides (eliminating the need to copy entire config files), and allows clients to subscribe to setting change callbacks. A mapping table shows how old Lua config files consolidate into new JSON equivalents. Persistent settings can optionally be saved to a state file across reboots. Schema validation is planned but not included in the first release. ## Full article daily.dev links to this article rather than hosting it. Read it at the original source: ## Questions this post answers ### How do I change WirePlumber settings at runtime without restarting? WirePlumber 0.5 stores settings in a PipeWire metadata object called 'sm-settings', which can be modified at runtime using pw-metadata. For example: `pw-metadata -n sm-settings 0 "stream.restore-props" false Spa:String:JSON`. Changes are applied live — subscribed Lua scripts and modules receive callbacks and react immediately, with no restart required. _Developers tuning WirePlumber audio policies without downtime track changes like these on daily.dev._ ### What is the difference between WirePlumber Lua config files and the new JSON config files in 0.5? WirePlumber 0.5 replaces per-feature Lua files with consolidated JSON .conf files. For example, 30-alsa-monitor.lua and 50-alsa-config.lua merge into alsa.conf, and 40-device-defaults.lua with 50-default-access-config.lua merge into device.conf. Settings are distributed under wireplumber.conf.d/ and stitched together at startup, enabling per-setting user overrides rather than full-file copies. _Linux audio developers migrating WirePlumber configs find the full mapping and rationale on daily.dev._ ### How do I enable persistent settings in WirePlumber so changes survive a reboot? Persistent settings in WirePlumber are disabled by default. To enable them, add `wireplumber.settings = { persistent.settings = true }` to wireplumber.conf. When enabled, settings are read from .conf files only on the first boot; subsequent reboots initialize from a state file that preserves any runtime changes made via pw-metadata. _Teams shipping WirePlumber-based products who need durable audio policy changes keep up with WirePlumber releases on daily.dev._ ## Similar posts on daily.dev - [Hyprland 0.55 Released With Lua-Based Configuration, User-Defined Layouts](https://daily.dev/posts/hyprland-0-55-released-with-lua-based-configuration-user-defined-layouts-w9ekzjxom) · Phoronix · 0 upvotes · 0 comments - [Lua with Erlang and Elixir](https://daily.dev/posts/lua-with-erlang-and-elixir-mhg9cmlze) · Erlang Solutions · 1 upvotes · 0 comments - [Hyprland 0.55 is here and you don't want to miss it\!](https://daily.dev/posts/hyprland-0-55-is-here-and-you-don-t-want-to-miss-it--cdocvdosv) · Hacker News · 1 upvotes · 0 comments - [Rust API and a new plugin system added to Miracle-WM](https://daily.dev/posts/rust-api-and-a-new-plugin-system-added-to-miracle-wm-yup7mtjhb) · omg\! ubuntu\! · 0 upvotes · 0 comments --- Tags: [#lua](https://daily.dev/tags/lua) [View this post on daily.dev](https://daily.dev/posts/from-lua-to-json-refactoring-wireplumber-s-configuration-system-6m9sxjw6i) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"From Lua to JSON: refactoring WirePlumber's configuration system","url":"https://daily.dev/posts/from-lua-to-json-refactoring-wireplumber-s-configuration-system-6m9sxjw6i","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/from-lua-to-json-refactoring-wireplumber-s-configuration-system-6m9sxjw6i"},"datePublished":"2026-08-11T08:57:23.275Z","dateModified":"2026-08-11T09:38:48.997Z","description":"WirePlumber's upcoming 0.5 release replaces Lua-based configuration with a JSON syntax (SPA JSON) inherited from PipeWire. The new system distributes settings...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/c190435a44cd7a7ae8837a2cfa439fd6?_a=AQAEuop","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/c190435a44cd7a7ae8837a2cfa439fd6?_a=AQAEuop","isAccessibleForFree":true,"articleSection":"Collabora Blog","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"Collabora Blog","logo":"https://media.daily.dev/image/upload/s--ZGZ0FjqS--/f_auto,q_auto/v1786438306/logos/collabora?_a=BAMAMicg0","url":"https://daily.dev/sources/collabora"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/from-lua-to-json-refactoring-wireplumber-s-configuration-system-6m9sxjw6i","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"lua","timeRequired":"PT10M"} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Collabora Blog","item":"https://daily.dev/sources/collabora"},{"@type":"ListItem","position":3,"name":"From Lua to JSON: refactoring WirePlumber's configuration system"}]} {"@context":"https://schema.org","@type":"FAQPage","@id":"https://daily.dev/posts/from-lua-to-json-refactoring-wireplumber-s-configuration-system-6m9sxjw6i#faq","mainEntity":[{"@type":"Question","name":"How do I change WirePlumber settings at runtime without restarting?","acceptedAnswer":{"@type":"Answer","text":"WirePlumber 0.5 stores settings in a PipeWire metadata object called 'sm-settings', which can be modified at runtime using pw-metadata. For example: `pw-metadata -n sm-settings 0 \"stream.restore-props\" false Spa:String:JSON`. Changes are applied live — subscribed Lua scripts and modules receive callbacks and react immediately, with no restart required. Developers tuning WirePlumber audio policies without downtime track changes like these on daily.dev."}},{"@type":"Question","name":"What is the difference between WirePlumber Lua config files and the new JSON config files in 0.5?","acceptedAnswer":{"@type":"Answer","text":"WirePlumber 0.5 replaces per-feature Lua files with consolidated JSON .conf files. For example, 30-alsa-monitor.lua and 50-alsa-config.lua merge into alsa.conf, and 40-device-defaults.lua with 50-default-access-config.lua merge into device.conf. Settings are distributed under wireplumber.conf.d/ and stitched together at startup, enabling per-setting user overrides rather than full-file copies. Linux audio developers migrating WirePlumber configs find the full mapping and rationale on daily.dev."}},{"@type":"Question","name":"How do I enable persistent settings in WirePlumber so changes survive a reboot?","acceptedAnswer":{"@type":"Answer","text":"Persistent settings in WirePlumber are disabled by default. To enable them, add `wireplumber.settings = { persistent.settings = true }` to wireplumber.conf. When enabled, settings are read from .conf files only on the first boot; subsequent reboots initialize from a state file that preserves any runtime changes made via pw-metadata. Teams shipping WirePlumber-based products who need durable audio policy changes keep up with WirePlumber releases on daily.dev."}}]} ```