From 438a9b7266d42be86293f642c52b50eddd865ddc Mon Sep 17 00:00:00 2001 From: GhostEagle68 Date: Mon, 24 Aug 2026 12:06:23 -0600 Subject: [PATCH 1/6] docs(config): add media and volume keybind examples with configurable step MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add commented-out media and volume keybinds to examples/config.toml so users can see how to wire up volume control with wpctl and media playback with playerctl. The volume step (5%) is a single number users change to their preference. Update docs/user/keybinds.md to use wpctl directly instead of noctalia for the volume example, with a comment clarifying the step size pattern. 🤖 Generated with Codebuff Co-Authored-By: Codebuff --- docs/user/keybinds.md | 6 +++--- examples/config.toml | 10 ++++++++++ 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/docs/user/keybinds.md b/docs/user/keybinds.md index 19ea19d5..29491d7a 100644 --- a/docs/user/keybinds.md +++ b/docs/user/keybinds.md @@ -313,9 +313,9 @@ and widgets via `noctalia msg`. Typical bindings: ## Example: media and brightness keys ```toml -# Volume (via Noctalia OSD) -"XF86AudioRaiseVolume" = "spawn:noctalia msg volume-up 2%" -"XF86AudioLowerVolume" = "spawn:noctalia msg volume-down 2%" +# Volume — change 5% to your preferred step size (1%, 3%, 10%, etc.) +"XF86AudioRaiseVolume" = "spawn:wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%+" +"XF86AudioLowerVolume" = "spawn:wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%-" "Mod+XF86AudioMute" = "spawn:wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle" # Media playback (playerctl) diff --git a/examples/config.toml b/examples/config.toml index 96c2d290..34ca39e7 100644 --- a/examples/config.toml +++ b/examples/config.toml @@ -221,6 +221,16 @@ follows_mouse = false # "Mod+C" = "window-center" # "Mod+Shift+T" = "workspace-set-layout:toggle" +# Media and volume (see docs/user/keybinds.md#example-media-and-brightness-keys) +# Change the number to set your preferred volume step (e.g. 1%, 2%, 5%, 10%). +# Requires: wpctl (PipeWire/WirePlumber), playerctl (media playback). +# "XF86AudioRaiseVolume" = "spawn:wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%+" +# "XF86AudioLowerVolume" = "spawn:wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%-" +# "Mod+XF86AudioMute" = "spawn:wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle" +# "XF86AudioPlay" = "spawn:playerctl play-pause" +# "XF86AudioNext" = "spawn:playerctl next" +# "XF86AudioPrev" = "spawn:playerctl prev" + # Window and layer rules (see docs/user/rules.md) --------------------------- # [[window_rule]] From cfe3403ffbedada5e3b33ca75de1cd87487f7fd2 Mon Sep 17 00:00:00 2001 From: GhostEagle68 Date: Mon, 24 Aug 2026 12:20:02 -0600 Subject: [PATCH 2/6] docs(keybinds): note that media keys can be remapped to any chord --- docs/user/keybinds.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/user/keybinds.md b/docs/user/keybinds.md index 29491d7a..4abc2690 100644 --- a/docs/user/keybinds.md +++ b/docs/user/keybinds.md @@ -331,3 +331,5 @@ and widgets via `noctalia msg`. Typical bindings: XF86 keys accept the same `Mod`, `Ctrl`, `Alt`, `Shift`, and `Super` combinations as other keys. Modifier chords also work when the XF86 key is reported by a separate laptop hotkey device. + +Don't have dedicated media keys? Change `XF86XXX` to `Mod+V`, `Ctrl+Alt+Up`, or any other binding. From 89e8789402aa952c613cfc286c3fde015c938993 Mon Sep 17 00:00:00 2001 From: GhostEagle68 Date: Mon, 24 Aug 2026 12:54:27 -0600 Subject: [PATCH 3/6] docs(keybinds): note wpctl and playerctl requirements for media keys --- docs/user/keybinds.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/user/keybinds.md b/docs/user/keybinds.md index 4abc2690..9894ceeb 100644 --- a/docs/user/keybinds.md +++ b/docs/user/keybinds.md @@ -332,4 +332,4 @@ XF86 keys accept the same `Mod`, `Ctrl`, `Alt`, `Shift`, and `Super` combinations as other keys. Modifier chords also work when the XF86 key is reported by a separate laptop hotkey device. -Don't have dedicated media keys? Change `XF86XXX` to `Mod+V`, `Ctrl+Alt+Up`, or any other binding. +Volume control requires `wpctl` (from WirePlumber/PipeWire) while media playback requires `playerctl`. Don't have dedicated media keys? Change `XF86XXX` to `Mod+V`, `Ctrl+Alt+Up`, or any other binding. From 98197d6c0e090eb468d1ad40a8501f1a47e0fb8d Mon Sep 17 00:00:00 2001 From: Lemmy Date: Tue, 25 Aug 2026 21:44:40 -0400 Subject: [PATCH 4/6] Refine media keybinds for volume adjustment Updated volume keybinds for audio control. --- docs/user/keybinds.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/user/keybinds.md b/docs/user/keybinds.md index 9894ceeb..e58bdc1f 100644 --- a/docs/user/keybinds.md +++ b/docs/user/keybinds.md @@ -313,7 +313,7 @@ and widgets via `noctalia msg`. Typical bindings: ## Example: media and brightness keys ```toml -# Volume — change 5% to your preferred step size (1%, 3%, 10%, etc.) +# Volume "XF86AudioRaiseVolume" = "spawn:wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%+" "XF86AudioLowerVolume" = "spawn:wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%-" "Mod+XF86AudioMute" = "spawn:wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle" From 6e61f4261fed43dacff7c0ed0e3a7ec9170ff1df Mon Sep 17 00:00:00 2001 From: Lemmy Date: Tue, 25 Aug 2026 21:45:49 -0400 Subject: [PATCH 5/6] Update keybinding instructions in keybinds.md Clarify keybinding instructions for volume control and media playback. --- docs/user/keybinds.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/user/keybinds.md b/docs/user/keybinds.md index e58bdc1f..b5d1fc29 100644 --- a/docs/user/keybinds.md +++ b/docs/user/keybinds.md @@ -332,4 +332,4 @@ XF86 keys accept the same `Mod`, `Ctrl`, `Alt`, `Shift`, and `Super` combinations as other keys. Modifier chords also work when the XF86 key is reported by a separate laptop hotkey device. -Volume control requires `wpctl` (from WirePlumber/PipeWire) while media playback requires `playerctl`. Don't have dedicated media keys? Change `XF86XXX` to `Mod+V`, `Ctrl+Alt+Up`, or any other binding. +Volume control requires `wpctl` (from WirePlumber/PipeWire) while media playback requires `playerctl`. From 51c6f1eb65b60980fc16e69d2a7e00e5fd09fbd0 Mon Sep 17 00:00:00 2001 From: Lemmy Date: Tue, 25 Aug 2026 21:46:25 -0400 Subject: [PATCH 6/6] Remove volume step configuration comments Removed comments about setting preferred volume steps and requirements for media playback. --- examples/config.toml | 2 -- 1 file changed, 2 deletions(-) diff --git a/examples/config.toml b/examples/config.toml index 34ca39e7..32a4f477 100644 --- a/examples/config.toml +++ b/examples/config.toml @@ -222,8 +222,6 @@ follows_mouse = false # "Mod+Shift+T" = "workspace-set-layout:toggle" # Media and volume (see docs/user/keybinds.md#example-media-and-brightness-keys) -# Change the number to set your preferred volume step (e.g. 1%, 2%, 5%, 10%). -# Requires: wpctl (PipeWire/WirePlumber), playerctl (media playback). # "XF86AudioRaiseVolume" = "spawn:wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%+" # "XF86AudioLowerVolume" = "spawn:wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%-" # "Mod+XF86AudioMute" = "spawn:wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle"