bug: `wayland.windowManager.hyprland.settings.exec-once` sets non-existent `hl.exec-once`

[kk-spartans]

Are you following the right branch?

• My Nixpkgs and Home Manager versions are in sync

Is there an existing issue for this?

• I have searched the existing issues

Issue description

Setting exec-once in my home-manager config for hyprland writes:

hl.exec-once("spotify")

to hyprland.lua. This is invalid, and makes hyprland fallback to the default config. The wiki reccomends using:

hl.on("hyprland.start", function () 
   hl.exec_cmd("spotify")
end)

Maintainer CC

@fufexan

System information

- system: `"x86_64-linux"`
 - host os: `Linux 7.0.5, NixOS, 26.05 (Yarara), 26.05.20260510.da5ad66`
 - multi-user?: `yes`
 - sandbox: `yes`
 - version: `nix-env (Nix) 2.34.7`
 - nixpkgs: `/nix/store/vp1i814m5cqfzh22bl76s1k9bc8iikkv-source`

[jstncnnr]

This is not a bug, this is the new behavior with stateVersion 26.05.

You can use wayland.windowManager.hyprland.configType = "hyprlang"; to generate your config using the old hyprlang syntax. This should be valid for a few more Hyprland releases. As of stateVersion 26.05 home-manager generates Lua config by default, and it takes settings.<name> and converts it into Lua as hl.<name>(...).

exec-once is no longer valid because it's not a valid function name in Lua. You can update it to exec_once if you'd prefer, but I don't why the Hyprland wiki now suggests waiting for their event to fire.

If you want to use Lua, and do what the wiki suggests, you'll have to adjust your nix config to be:

wayland.windowManager.hyprland.settings = {
  on = {
    _args = [
      "hyprland.start"
      (lib.generators.mkLuaInline "function()\n  hl.exec_cmd(\"spotify\")\nend")
    ];
  };
};