374e6bcc40
Format all Nix files using the officially approved formatter,
making the CI check introduced in the previous commit succeed:
nix-build ci -A fmt.check
This is the next step of the of the [implementation](https://github.com/NixOS/nixfmt/issues/153)
of the accepted [RFC 166](https://github.com/NixOS/rfcs/pull/166).
This commit will lead to merge conflicts for a number of PRs,
up to an estimated ~1100 (~33%) among the PRs with activity in the past 2
months, but that should be lower than what it would be without the previous
[partial treewide format](https://github.com/NixOS/nixpkgs/pull/322537).
Merge conflicts caused by this commit can now automatically be resolved while rebasing using the
[auto-rebase script](8616af08d9/maintainers/scripts/auto-rebase).
If you run into any problems regarding any of this, please reach out to the
[formatting team](https://nixos.org/community/teams/formatting/) by
pinging @NixOS/nix-formatting.
314 lines
11 KiB
Nix
314 lines
11 KiB
Nix
{
|
|
config,
|
|
lib,
|
|
pkgs,
|
|
...
|
|
}:
|
|
|
|
let
|
|
inherit (builtins) concatMap;
|
|
inherit (lib) maintainers;
|
|
inherit (lib.attrsets) attrByPath mapAttrsToList;
|
|
inherit (lib.lists) flatten optional;
|
|
inherit (lib.modules) mkIf;
|
|
inherit (lib.options) literalExpression mkOption;
|
|
inherit (lib.strings) concatStringsSep makeSearchPath;
|
|
inherit (lib.types)
|
|
bool
|
|
listOf
|
|
attrsOf
|
|
package
|
|
lines
|
|
;
|
|
inherit (lib.path) subpath;
|
|
|
|
pwCfg = config.services.pipewire;
|
|
cfg = pwCfg.wireplumber;
|
|
pwUsedForAudio = pwCfg.audio.enable;
|
|
|
|
json = pkgs.formats.json { };
|
|
|
|
configSectionsToConfFile =
|
|
path: value:
|
|
pkgs.writeTextDir path (
|
|
concatStringsSep "\n" (
|
|
mapAttrsToList (section: content: "${section} = " + (builtins.toJSON content)) value
|
|
)
|
|
);
|
|
|
|
mapConfigToFiles =
|
|
config:
|
|
mapAttrsToList (
|
|
name: value: configSectionsToConfFile "share/wireplumber/wireplumber.conf.d/${name}.conf" value
|
|
) config;
|
|
|
|
mapScriptsToFiles =
|
|
scripts:
|
|
mapAttrsToList (
|
|
relativePath: value:
|
|
pkgs.writeTextDir (subpath.join [
|
|
"share/wireplumber/scripts"
|
|
relativePath
|
|
]) value
|
|
) scripts;
|
|
in
|
|
{
|
|
meta.maintainers = [ maintainers.k900 ];
|
|
|
|
options = {
|
|
services.pipewire.wireplumber = {
|
|
enable = mkOption {
|
|
type = bool;
|
|
default = pwCfg.enable;
|
|
defaultText = literalExpression "config.services.pipewire.enable";
|
|
description = "Whether to enable WirePlumber, a modular session / policy manager for PipeWire";
|
|
};
|
|
|
|
package = mkOption {
|
|
type = package;
|
|
default = pkgs.wireplumber;
|
|
defaultText = literalExpression "pkgs.wireplumber";
|
|
description = "The WirePlumber derivation to use.";
|
|
};
|
|
|
|
extraConfig = mkOption {
|
|
# Two layer attrset is necessary before using JSON, because of the whole
|
|
# config file not being a JSON object, but a concatenation of JSON objects
|
|
# in sections.
|
|
type = attrsOf (attrsOf json.type);
|
|
default = { };
|
|
example = literalExpression ''
|
|
{
|
|
"log-level-debug" = {
|
|
"context.properties" = {
|
|
# Output Debug log messages as opposed to only the default level (Notice)
|
|
"log.level" = "D";
|
|
};
|
|
};
|
|
"wh-1000xm3-ldac-hq" = {
|
|
"monitor.bluez.rules" = [
|
|
{
|
|
matches = [
|
|
{
|
|
# Match any bluetooth device with ids equal to that of a WH-1000XM3
|
|
"device.name" = "~bluez_card.*";
|
|
"device.product.id" = "0x0cd3";
|
|
"device.vendor.id" = "usb:054c";
|
|
}
|
|
];
|
|
actions = {
|
|
update-props = {
|
|
# Set quality to high quality instead of the default of auto
|
|
"bluez5.a2dp.ldac.quality" = "hq";
|
|
};
|
|
};
|
|
}
|
|
];
|
|
};
|
|
}
|
|
'';
|
|
description = ''
|
|
Additional configuration for the WirePlumber daemon when run in
|
|
single-instance mode (the default in nixpkgs and currently the only
|
|
supported way to run WirePlumber configured via `extraConfig`).
|
|
|
|
See also:
|
|
- [The configuration file][docs-the-conf-file]
|
|
- [Modifying configuration][docs-modifying-config]
|
|
- [Locations of files][docs-file-locations]
|
|
- and the [configuration section][docs-config-section] of the docs in general
|
|
|
|
Note that WirePlumber (and PipeWire) use dotted attribute names like
|
|
`device.product.id`. These are not nested, but flat objects for WirePlumber/PipeWire,
|
|
so to write these in nix expressions, remember to quote them like `"device.product.id"`.
|
|
Have a look at the example for this.
|
|
|
|
[docs-the-conf-file]: https://pipewire.pages.freedesktop.org/wireplumber/daemon/configuration/conf_file.html
|
|
[docs-modifying-config]: https://pipewire.pages.freedesktop.org/wireplumber/daemon/configuration/modifying_configuration.html
|
|
[docs-file-locations]: https://pipewire.pages.freedesktop.org/wireplumber/daemon/configuration/locations.html
|
|
[docs-config-section]: https://pipewire.pages.freedesktop.org/wireplumber/daemon/configuration.html
|
|
'';
|
|
};
|
|
|
|
extraScripts = mkOption {
|
|
type = attrsOf lines;
|
|
default = { };
|
|
example = {
|
|
"test/hello-world.lua" = ''
|
|
print("Hello, world!")
|
|
'';
|
|
};
|
|
description = ''
|
|
Additional scripts for WirePlumber to be used by configuration files.
|
|
|
|
Every item in this attrset becomes a separate lua file with the path
|
|
relative to the `scripts` directory specified in the name of the item.
|
|
The scripts get passed to the WirePlumber service via the `XDG_DATA_DIRS`
|
|
variable. Scripts specified here are preferred over those shipped with
|
|
WirePlumber if they occupy the same relative path.
|
|
|
|
For a script to be loaded, it needs to be specified as part of a component,
|
|
and that component needs to be required by an active profile (e.g. `main`).
|
|
Components can be defined in config files either via `extraConfig` or `configPackages`.
|
|
|
|
For the hello-world example, you'd have to add the following `extraConfig`:
|
|
```nix
|
|
services.pipewire.wireplumber.extraConfig."99-hello-world" = {
|
|
"wireplumber.components" = [
|
|
{
|
|
name = "test/hello-world.lua";
|
|
type = "script/lua";
|
|
provides = "custom.hello-world";
|
|
}
|
|
];
|
|
|
|
"wireplumber.profiles" = {
|
|
main = {
|
|
"custom.hello-world" = "required";
|
|
};
|
|
};
|
|
};
|
|
```
|
|
|
|
See also:
|
|
- [Location of scripts][docs-file-locations-scripts]
|
|
- [Components & Profiles][docs-components-profiles]
|
|
- [Migration - Loading custom scripts][docs-migration-loading-custom-scripts]
|
|
|
|
[docs-file-locations-scripts]: https://pipewire.pages.freedesktop.org/wireplumber/daemon/locations.html#location-of-scripts
|
|
[docs-components-profiles]: https://pipewire.pages.freedesktop.org/wireplumber/daemon/configuration/components_and_profiles.html
|
|
[docs-migration-loading-custom-scripts]: https://pipewire.pages.freedesktop.org/wireplumber/daemon/configuration/migration.html#loading-custom-scripts
|
|
'';
|
|
};
|
|
|
|
configPackages = mkOption {
|
|
type = listOf package;
|
|
default = [ ];
|
|
example = literalExpression ''
|
|
[
|
|
(pkgs.writeTextDir "share/wireplumber/wireplumber.conf.d/10-bluez.conf" '''
|
|
monitor.bluez.properties = {
|
|
bluez5.roles = [ a2dp_sink a2dp_source bap_sink bap_source hsp_hs hsp_ag hfp_hf hfp_ag ]
|
|
bluez5.codecs = [ sbc sbc_xq aac ]
|
|
bluez5.enable-sbc-xq = true
|
|
bluez5.hfphsp-backend = "native"
|
|
}
|
|
''')
|
|
]
|
|
'';
|
|
description = ''
|
|
List of packages that provide WirePlumber configuration, in the form of
|
|
`share/wireplumber/*/*.conf` files.
|
|
|
|
LV2 dependencies will be picked up from config packages automatically
|
|
via `passthru.requiredLv2Packages`.
|
|
'';
|
|
};
|
|
|
|
extraLv2Packages = mkOption {
|
|
type = listOf package;
|
|
default = [ ];
|
|
example = literalExpression "[ pkgs.lsp-plugins ]";
|
|
description = ''
|
|
List of packages that provide LV2 plugins in `lib/lv2` that should
|
|
be made available to WirePlumber for [filter chains][wiki-filter-chain].
|
|
|
|
Config packages have their required LV2 plugins added automatically,
|
|
so they don't need to be specified here. Config packages need to set
|
|
`passthru.requiredLv2Packages` for this to work.
|
|
|
|
[wiki-filter-chain]: https://docs.pipewire.org/page_module_filter_chain.html
|
|
'';
|
|
};
|
|
};
|
|
};
|
|
|
|
config =
|
|
let
|
|
pwNotForAudioConfigPkg = pkgs.writeTextDir "share/wireplumber/wireplumber.conf.d/90-nixos-no-audio.conf" ''
|
|
# PipeWire is not used for audio, so WirePlumber should not be handling it
|
|
wireplumber.profiles = {
|
|
main = {
|
|
hardware.audio = disabled
|
|
hardware.bluetooth = disabled
|
|
}
|
|
}
|
|
'';
|
|
|
|
extraConfigPkg = pkgs.buildEnv {
|
|
name = "wireplumber-extra-config";
|
|
paths = mapConfigToFiles cfg.extraConfig;
|
|
pathsToLink = [ "/share/wireplumber/wireplumber.conf.d" ];
|
|
};
|
|
|
|
extraScriptsPkg = pkgs.buildEnv {
|
|
name = "wireplumber-extra-scrips";
|
|
paths = mapScriptsToFiles cfg.extraScripts;
|
|
pathsToLink = [ "/share/wireplumber/scripts" ];
|
|
};
|
|
|
|
configPackages =
|
|
cfg.configPackages
|
|
++ [
|
|
extraConfigPkg
|
|
extraScriptsPkg
|
|
]
|
|
++ optional (!pwUsedForAudio) pwNotForAudioConfigPkg;
|
|
|
|
configs = pkgs.buildEnv {
|
|
name = "wireplumber-configs";
|
|
paths = configPackages;
|
|
pathsToLink = [ "/share/wireplumber" ];
|
|
};
|
|
|
|
requiredLv2Packages = flatten (
|
|
concatMap (p: attrByPath [ "passthru" "requiredLv2Packages" ] [ ] p) configPackages
|
|
);
|
|
|
|
lv2Plugins = pkgs.buildEnv {
|
|
name = "wireplumber-lv2-plugins";
|
|
paths = cfg.extraLv2Packages ++ requiredLv2Packages;
|
|
pathsToLink = [ "/lib/lv2" ];
|
|
};
|
|
in
|
|
mkIf cfg.enable {
|
|
assertions = [
|
|
{
|
|
assertion = !config.hardware.bluetooth.hsphfpd.enable;
|
|
message = "Using WirePlumber conflicts with hsphfpd, as it provides the same functionality. `hardware.bluetooth.hsphfpd.enable` needs be set to false";
|
|
}
|
|
];
|
|
|
|
environment.systemPackages = [ cfg.package ];
|
|
|
|
systemd.packages = [ cfg.package ];
|
|
|
|
systemd.services.wireplumber.enable = pwCfg.systemWide;
|
|
systemd.user.services.wireplumber.enable = !pwCfg.systemWide;
|
|
|
|
systemd.services.wireplumber.wantedBy = [ "pipewire.service" ];
|
|
systemd.user.services.wireplumber.wantedBy = [ "pipewire.service" ];
|
|
|
|
systemd.services.wireplumber.environment = mkIf pwCfg.systemWide {
|
|
# Force WirePlumber to use system dbus.
|
|
DBUS_SESSION_BUS_ADDRESS = "unix:path=/run/dbus/system_bus_socket";
|
|
|
|
# Make WirePlumber find our config/script files and lv2 plugins required by those
|
|
# (but also the configs/scripts shipped with WirePlumber)
|
|
XDG_DATA_DIRS = makeSearchPath "share" [
|
|
configs
|
|
cfg.package
|
|
];
|
|
LV2_PATH = "${lv2Plugins}/lib/lv2";
|
|
};
|
|
|
|
systemd.user.services.wireplumber.environment = mkIf (!pwCfg.systemWide) {
|
|
XDG_DATA_DIRS = makeSearchPath "share" [
|
|
configs
|
|
cfg.package
|
|
];
|
|
LV2_PATH = "${lv2Plugins}/lib/lv2";
|
|
};
|
|
};
|
|
}
|