canoe 0.2.0

Canoe, a River window manager implementation in Rust
canoe-0.2.0 is not a library.

Canoe 🛶 - River Window Manager

A stacking window manager for the River Wayland compositor, written in Rust.

Building

cargo build --release

Running

river -c ./target/release/canoe

For debug output:

RUST_LOG=info river -c ./target/release/canoe

Configuration

Canoe reads ~/.config/canoe/canoe.toml. The main modifier defaults to super, but you can change it:

main_modifier = "alt"

Keyboard Shortcuts

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+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

Mouse Actions

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)

Features

  • Stacking window management
  • Yellow window borders (10px)
  • Yellow titlebars (24px)
  • Server-side decorations
  • Titlebar/edge window movement and resizing (Super+Drag anywhere)
  • Window focus follows click

Requirements

  • River compositor
  • foot terminal (for Super+Shift+Return)
  • fuzzel (for Super+Space launcher)

License

MIT