Skip to content

Commit

Permalink
binds: Improve docs for workspace key binds on non-qwerty keyboards. (#…
Browse files Browse the repository at this point in the history
…824)

Explain why the defaults for the workspaces do not work on a french azerty keyboard, and how to fix it.

Fixes  #810
  • Loading branch information
aaron-randreth authored Oct 24, 2024
1 parent 887fe11 commit 575c48b
Showing 1 changed file with 20 additions and 0 deletions.
20 changes: 20 additions & 0 deletions pages/Configuring/Binds.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,26 @@ can also use `xev` or `wev` to find keycodes.

## Misc

### Workspace bindings on non-qwerty layouts

Keys used for keybinds need to be accessible without any modifiers in your layout. For instance, the `French Azerty` layout uses `SHIFT+unmodified_key` to write `0-9` numbers. As such, the workspace keybinds for this layout need to use the names of the `unmodified_key`s, and will not work when using the `0-9` numbers.

{{< callout type=info >}}

To get the correct name for an `unmodified_key`, refer to [the section on uncommon syms](#uncommon-syms--binding-with-a-keycode)

{{< /callout >}}

```ini
# On a french layout, instead of
# bind = $mainMod, 1, workspace, 1

# Use
bind = $mainMod, ampersand, workspace, 1
```

For help configuring the `French Azerty` layout, [see](https://rherault.dev/articles/hyprland-fr-layout).

### Unbind

You can also unbind with `unbind`, e.g.:
Expand Down

0 comments on commit 575c48b

Please sign in to comment.