A stacking window manager for the River Wayland compositor, written in Rust.
- Stacking window management
- Server-side decorations with classic window borders & titlebars
- Titlebar/edge window movement and resizing (Super+Drag anywhere)
- Multihead support (focus/send windows across outputs)
- Window switcher (keyboard cycle + desktop right-click menu)
- Window focus follows click
- Optional forcing server-side decorations via per-window rules
- Optional "swallowing" of client-side decoration via per-window rules
cargo install canoeriver -c canoecargo build --release| Shortcut | Action |
|---|---|
Super+Shift+Return |
Open terminal (foot) |
Super+Space |
Open application launcher (fuzzel) |
Super+w |
Close focused window |
Super+Tab |
Focus next window |
Super+Shift+Tab |
Focus previous window |
Super+` |
Focus next window of the same application |
Super+Enter |
Toggle fullscreen |
Super+Down |
Unfullscreen/unmaximize, otherwise minimize focused window |
Super+Up |
Maximize focused window |
Super+h |
Minimize focused window |
Super+m |
Minimize focused window |
Super+Left |
Snap focused window to left half; restore if snapped right |
Super+Right |
Snap focused window to right half; restore if snapped left |
Super+Alt+Left |
Send focused window to previous output |
Super+Alt+Right |
Send focused window to next output |
Super+Alt+Up |
Send focused window to previous output |
Super+Alt+Down |
Send focused window to next output |
| Action | Result |
|---|---|
| Click on window | Focus window |
| Drag titlebar | Move window |
| Drag window edges | Resize window |
Super+Left Drag |
Move window (anywhere) |
Super+Right Drag |
Resize window (anywhere) |
Canoe reads ~/.config/canoe/canoe.toml.
The main modifier defaults to super, but you can change it:
main_modifier = "alt"The launcher defaults to fuzzel. You can override it with a command or argv:
launcher_cmd = "fuzzel"
# Or with arguments:
launcher_cmd = ["fuzzel", "--dmenu"]UI options live under the [ui] table and let you tune borders, titlebars, and menu colors.
Colors accept #RGB, #RRGGBB, or #RRGGBBAA.
[ui]
border_width = 10
border_active = { outer = "#FFD000", mid = "#000000", inner = "#FFD000" }
border_inactive = { outer = "#000000", mid = "#000000", inner = "#000000" }
titlebar_text_active = "#000000"
titlebar_text_inactive = "#808080"
titlebar_bg_active = "#FFD000"
titlebar_bg_inactive = "#202020"
menu_bg = "#000000"
menu_text = "#FFFFFF"
menu_highlight_bg = "#FFD000"
menu_highlight_text = "#000000"
button_bg = "#202020"
button_highlight = "#FFD000"
button_shadow = "#000000"
font_name = "Sans"
font_size = 12.0
desktop_background = "#101010"Rules live under [[rules]] in canoe.toml. App ID matching uses OR across the
app-id fields, and property matching uses AND across the listed properties.
[[rules]]
match_app_id = ["foot", "kitty"] # exact match, any value matches
match_app_id_prefix = "mate-" # prefix match (e.g. mate-calc)
match_props = ["toplevel", "csd_only"] # all props must matchSupported match_props values:
toplevel(window has no parent)csd_only(client does not support SSD)
The matching windows can have parts of their content "swallowed". This removes the client-side decoration on my Firefox, for instance:
match_app_id = "firefox-esr"
match_props = "toplevel"
force_ssd = true
swallow_top = 48- River Wayland compositor
- foot terminal (for Super+Shift+Return)
- fuzzel (for Super+Space launcher)
MIT