From a51517083c7a8133373ee286db101194a38a7d6f Mon Sep 17 00:00:00 2001 From: tcz0g Date: Sat, 11 Jul 2026 01:05:54 +0200 Subject: [PATCH 1/6] Update hyprland.mdx adjust local ipc --- .../docs/v5/compositor-settings/hyprland.mdx | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/src/content/docs/v5/compositor-settings/hyprland.mdx b/src/content/docs/v5/compositor-settings/hyprland.mdx index d5c5b0d3..438542c4 100644 --- a/src/content/docs/v5/compositor-settings/hyprland.mdx +++ b/src/content/docs/v5/compositor-settings/hyprland.mdx @@ -71,19 +71,19 @@ hl.workspace_rule({ workspace = "5", monitor = "DP-1", persistent = true }) Add these binds to your `hyprland.lua`: ```lua -local ipc = "noctalia msg" +local ipc = "noctalia msg " -- Core binds -hl.bind(mainMod .. "+Space", hl.dsp.exec_cmd(ipc .. " panel-toggle launcher")) -hl.bind(mainMod .. "+S", hl.dsp.exec_cmd(ipc .. " panel-toggle control-center")) -hl.bind(mainMod .. "+comma", hl.dsp.exec_cmd(ipc .. " settings-toggle")) +hl.bind(mainMod .. "+Space", hl.dsp.exec_cmd(ipc .. "panel-toggle launcher")) +hl.bind(mainMod .. "+S", hl.dsp.exec_cmd(ipc .. "panel-toggle control-center")) +hl.bind(mainMod .. "+comma", hl.dsp.exec_cmd(ipc .. "settings-toggle")) -- Media keys -hl.bind("XF86AudioRaiseVolume", hl.dsp.exec_cmd(ipc .. " volume-up")) -hl.bind("XF86AudioLowerVolume", hl.dsp.exec_cmd(ipc .. " volume-down")) -hl.bind("XF86AudioMute", hl.dsp.exec_cmd(ipc .. " volume-mute")) -hl.bind("XF86MonBrightnessUp", hl.dsp.exec_cmd(ipc .. " brightness-up")) -hl.bind("XF86MonBrightnessDown", hl.dsp.exec_cmd(ipc .. " brightness-down")) +hl.bind("XF86AudioRaiseVolume", hl.dsp.exec_cmd(ipc .. "volume-up")) +hl.bind("XF86AudioLowerVolume", hl.dsp.exec_cmd(ipc .. "volume-down")) +hl.bind("XF86AudioMute", hl.dsp.exec_cmd(ipc .. "volume-mute")) +hl.bind("XF86MonBrightnessUp", hl.dsp.exec_cmd(ipc .. "brightness-up")) +hl.bind("XF86MonBrightnessDown", hl.dsp.exec_cmd(ipc .. "brightness-down")) -- Noctalia Settings hl.window_rule({ From cb12340fd6f90c4fe15658395bf26b43b869fda8 Mon Sep 17 00:00:00 2001 From: tcz0g Date: Sat, 11 Jul 2026 01:07:15 +0200 Subject: [PATCH 2/6] Update shell.mdx to new hyprlang syntax --- src/content/docs/v5/ipc/shell.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/v5/ipc/shell.mdx b/src/content/docs/v5/ipc/shell.mdx index 52b9addd..50e1fe6d 100644 --- a/src/content/docs/v5/ipc/shell.mdx +++ b/src/content/docs/v5/ipc/shell.mdx @@ -35,7 +35,7 @@ Alt+Tab-style overlay: a dimmed fullscreen layer with a centered grid of open wi Example Hyprland bind: ```ini -bind = ALT, Tab, exec, noctalia msg window-switcher +hl.bind("ALT + Tab", hl.dsp.exec_cmd("noctalia msg window-switcher")) ``` While the overlay is open it takes exclusive keyboard focus on its layer surface: From 27cc866789e1b578a6e89d73a0742ca975602aa6 Mon Sep 17 00:00:00 2001 From: tcz0g Date: Sun, 12 Jul 2026 10:53:05 +0200 Subject: [PATCH 3/6] Update shell.mdx (credit to aethi from the noctalia discord) added some Hyprland specific configuration due to weird alt tab behaviour --- src/content/docs/v5/ipc/shell.mdx | 28 +++++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) diff --git a/src/content/docs/v5/ipc/shell.mdx b/src/content/docs/v5/ipc/shell.mdx index 50e1fe6d..7545c7e7 100644 --- a/src/content/docs/v5/ipc/shell.mdx +++ b/src/content/docs/v5/ipc/shell.mdx @@ -35,7 +35,7 @@ Alt+Tab-style overlay: a dimmed fullscreen layer with a centered grid of open wi Example Hyprland bind: ```ini -hl.bind("ALT + Tab", hl.dsp.exec_cmd("noctalia msg window-switcher")) +hl.bind("ALT + TAB", hl.dsp.exec_cmd("noctalia msg window-switcher")) ``` While the overlay is open it takes exclusive keyboard focus on its layer surface: @@ -48,6 +48,32 @@ While the overlay is open it takes exclusive keyboard focus on its layer surface The window list refreshes while the overlay stays open (new windows, closed windows, and title changes such as Discord channel switches). Selection stays on the same window when its title updates. +### Hyprland specific configuration + +Please add this to your `hyprland.lua` for intended Alt Tab behaviour: +**This only applies to the specific `ALT + TAB` keybind, disregard the following configuration if you are using e.g. `SUPER + TAB`** + +```ini +hl.bind('ALT + TAB', function() +hl.dispatch(hl.dsp.exec_cmd("noctalia msg window-switcher")) +hl.dispatch(hl.dsp.submap 'window_switcher') +end) + +hl.define_submap('window_switcher', function() +hl.bind('RETURN', hl.dsp.submap 'reset') -- Necessary for the submap to register + +hl.on('layer.closed', function(layer) +if layer.namespace == 'noctalia-window-switcher' then hl.dispatch(hl.dsp.submap 'reset') end + end) +end) +``` + +Please note that some of the follwing overlay keybinds might not work when the keybind is set to `ALT + TAB`: +- **Arrow keys** - move within the grid (up to five columns) +- **Enter** - focus the selected window and close +- **Escape** - close without switching + + ## Session | Action | Command | Description | From 843acbd69ebf801f8240cf9e74cd1c58b1517cad Mon Sep 17 00:00:00 2001 From: tcz0g Date: Sun, 12 Jul 2026 10:56:17 +0200 Subject: [PATCH 4/6] fixing formatting --- src/content/docs/v5/ipc/shell.mdx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/content/docs/v5/ipc/shell.mdx b/src/content/docs/v5/ipc/shell.mdx index 7545c7e7..2c261db2 100644 --- a/src/content/docs/v5/ipc/shell.mdx +++ b/src/content/docs/v5/ipc/shell.mdx @@ -50,7 +50,8 @@ The window list refreshes while the overlay stays open (new windows, closed wind ### Hyprland specific configuration -Please add this to your `hyprland.lua` for intended Alt Tab behaviour: +Add this to your `hyprland.lua` for intended Alt+Tab behaviour: + **This only applies to the specific `ALT + TAB` keybind, disregard the following configuration if you are using e.g. `SUPER + TAB`** ```ini From 39a6f35c309e896f219340b25e87136d14f68764 Mon Sep 17 00:00:00 2001 From: tcz0g Date: Sun, 12 Jul 2026 11:26:56 +0200 Subject: [PATCH 5/6] typo --- src/content/docs/v5/ipc/shell.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/v5/ipc/shell.mdx b/src/content/docs/v5/ipc/shell.mdx index 2c261db2..d4fc13c6 100644 --- a/src/content/docs/v5/ipc/shell.mdx +++ b/src/content/docs/v5/ipc/shell.mdx @@ -69,7 +69,7 @@ if layer.namespace == 'noctalia-window-switcher' then hl.dispatch(hl.dsp.submap end) ``` -Please note that some of the follwing overlay keybinds might not work when the keybind is set to `ALT + TAB`: +Please note that some of the following overlay keybinds might not work when the keybind is set to `ALT + TAB`: - **Arrow keys** - move within the grid (up to five columns) - **Enter** - focus the selected window and close - **Escape** - close without switching From 8e94a6c79c0cb8bcd89d881814142f97f04734ea Mon Sep 17 00:00:00 2001 From: tcz0g Date: Sun, 12 Jul 2026 11:27:38 +0200 Subject: [PATCH 6/6] fix typo --- src/content/docs/v5/getting-started/installation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/v5/getting-started/installation.mdx b/src/content/docs/v5/getting-started/installation.mdx index d8053f44..7d849b04 100644 --- a/src/content/docs/v5/getting-started/installation.mdx +++ b/src/content/docs/v5/getting-started/installation.mdx @@ -280,7 +280,7 @@ sudo apt install noctalia **Step 4**: Ensure signing key remains current -The key used to sign the packages will be updated each year. To avoid needing to manaully reinstall it (repeating Step 1), install the key package so that it will automatically update. +The key used to sign the packages will be updated each year. To avoid needing to manually reinstall it (repeating Step 1), install the key package so that it will automatically update. ```bash sudo apt install nickh-archive-keyring ```