A trackpad-first infinite canvas Wayland compositor.
Primary repository: GitHub · Mirror: Codeberg
demo.mp4
Traditional window managers arrange windows to fit your screen. Stacking compositors do so by piling windows on top of each other; tiling compositors do so by squeezing them to fit and utilizing workspaces.
driftwm is an infinite-canvas compositor: windows live at their native size on an infinite 2D canvas, and your display is a camera viewing it. When two windows come close, they snap together, forming implicit groups that can be moved, resized, and viewed together. No tiling, no workspaces, window overlaps happen only on purpose.
Navigation is built around trackpad gestures, but every gesture has a mouse or keyboard equivalent and touchscreens have their own bindings, so it works the same on a laptop and at a desk.
Built on smithay. Inspired by vxwm; borrows implementation details from niri.
Warning
This is experimental software, primarily built with AI.
pan_zoom.mp4
Infinite 2D canvas with viewport panning, zoom, and scroll momentum. A quick flick carries the viewport smoothly until friction stops it.
Pan & zoom bindings
| Input | Action | Context |
|---|---|---|
| 3-finger swipe | Pan viewport | anywhere |
| Trackpad scroll | Pan viewport | on-canvas |
Mod + LMB drag |
Pan viewport | anywhere |
Mod+Ctrl + arrow |
Pan viewport | — |
| 2-finger pinch | Zoom | on-canvas |
| 3-finger pinch | Zoom | anywhere |
| Mouse wheel | Zoom | on-canvas |
Mod + scroll |
Zoom at cursor | anywhere |
Mod+= / Mod+- |
Zoom in / out | — |
Mod+0 |
Reset zoom to 1.0 | — |
navigation.mp4
Jump to the nearest window in any direction. MRU cycling (Alt-Tab) with
hold-to-commit. Zoom-to-fit shows all windows at once. Configurable anchors
act as navigation targets for directional jumps even with no window there —
useful for areas with pinned widgets. Bookmarks: named canvas
spots the camera jumps straight to.
Navigation bindings
| Input | Action |
|---|---|
Mod + arrow |
Focus nearest window in direction; scrolls it just in within a cluster, centers it from another |
| 4-finger swipe | Focus nearest window (natural direction) |
Mod+Ctrl + LMB drag |
Focus nearest window (natural direction) |
Alt-Tab / Alt-Shift-Tab |
Cycle windows (MRU) |
4-finger pinch in / Mod+W |
Zoom-to-fit (overview) |
4-finger pinch out / Mod+A |
Home toggle (origin and back) |
4-finger hold / Mod+X |
Center and focus the window under the pointer |
Mod+C |
Center focused window |
Mod+1-4 |
Jump to bookmarked canvas position |
Mod+Shift+1-4 |
Save the current position as that bookmark |
All 4-finger navigation gestures also work as Mod + 3-finger for smaller
trackpads.
snap.mp4
Move window with 3-finger doubletap-swipe or Alt + drag. Resize with Alt + 3-finger swipe. Snapping kicks in as edges approach each other. Drag past the viewport edge and the canvas auto-pans.
Snapped windows form a cluster. Neighbors stay visible at your view's edge for spatial context. Resizing and fitting keep the cluster intact, and Shift acts on the window alone; moving takes one window, and Shift carries the whole cluster. Shuffle a layout in one drag, resize a row of panes proportionally, or scope an overview to just the cluster (Mod+Shift+W). No explicit grouping to manage.
Tip
While dragging a window, keyboard shortcuts still work. Use Mod+1-4
to jump to a bookmark or Mod+A to go home — your held window comes with you.
Fit-window (Mod+M) is the maximize analogue — centers the viewport, resets
zoom to 1.0, and resizes the window to fill the screen, its snapped neighbors
moving out to stay attached. Toggle again to restore. Fullscreen (Mod+F)
fills the screen with the focused window until any canvas action — launching
an app, navigating — exits it.
Snapping & window bindings
| Input | Action |
|---|---|
| 3-finger doubletap-swipe | Move window |
Alt + LMB drag |
Move window |
Alt+Shift + LMB drag |
Move snapped windows |
Alt + 3-finger swipe |
Resize snapped window |
Alt+Shift + 3-finger swipe |
Resize window |
Alt + RMB drag |
Resize snapped window |
Alt+Shift + RMB drag |
Resize window |
Alt + MMB click / Mod+M |
Fit snapped window (maximize/restore) |
Alt+Shift + MMB click / Mod+Shift+M |
Fit window |
Mod + MMB click |
Fill free space (press again to undo) |
Mod + 4-finger pinch in / Mod+Shift+W |
Zoom-to-fit snapped windows |
Mod+F |
Toggle fullscreen |
Mod+Shift + arrow |
Move to the next snap stop |
touch.mp4
Everything works by touch too: pan and zoom the canvas, jump between windows, and move or resize windows — even whole window groups — exactly as you would on a trackpad.
Touch gestures
| Input | Action | Context |
|---|---|---|
| 1-finger swipe | Pan viewport | on-canvas |
| 2-finger swipe | Pan viewport | on-canvas |
| 3-finger swipe | Pan viewport | anywhere |
| 2-finger pinch | Zoom | on-canvas |
| 3-finger pinch | Zoom | anywhere |
| 4-finger swipe | Focus nearest window | anywhere |
| 4-finger pinch in / out | Zoom-to-fit / home toggle | anywhere |
| 3-finger tap | Center window | anywhere |
| 3-finger double-tap | Fit snapped window | on-window |
| 3-finger doubletap-swipe | Move window (hold: cluster) | on-window |
| 3-finger hold-swipe | Resize snapped window | on-window |
background.mp4
gigapixel_wp.mp4
The background is part of the canvas — it scrolls and zooms with the viewport, not stuck to the screen.
Five modes:
default— the built-in dot grid, what you get with no configuration.shader— procedural GLSL, animated or static, optionally sampling an image viatexture. See docs/shaders.md to write your own. Bundled shaders live inextras/wallpapers/{static,animated,textured}/.tile— PNG/JPG (single texture, tiled infinitely), or a tiled pyramidal TIFF for gigapixel wallpapers. Setmirror_tile = trueto mirror-fold a non-seamless image so it tiles without seams (kaleidoscope look).wallpaper— single image scaled to cover the viewport, aspect-preserving (does not scroll/zoom) — a classic desktop wallpaper.none— no built-in background, so an externalwlr-layer-shellwallpaper daemon (swaybg,swww,mpvpaperfor live video) becomes the wallpaper instead.
[background]
type = "shader"
path = "~/.config/driftwm/bg.glsl"
# texture = "~/Pictures/img.jpg" # if it's a texture-based shader
# Or: type = "tile", path = "~/Pictures/tile.png"
# Or: type = "tile", path = "~/Pictures/world.tif" # pyramidal TIFF
# Or: type = "wallpaper", path = "~/Pictures/wallpaper.jpg"
# Or: type = "none" # external wallpaper daemon (swaybg/mpvpaper/…)window_rules.mp4
Match windows by app_id and/or title (glob patterns) and control position,
size, decorations, blur, opacity, key pass-through, and placement — fields
combine freely.
Two special placement modes: widget = true fixes a window to the canvas
(immovable, below normal windows, out of Alt-Tab — clocks, trays, and
layer-shell surfaces like waybar); pinned_to_screen = true fixes it to the
screen instead, so it ignores pan/zoom and floats above normal windows
(Picture-in-Picture, call toolbars) — toggleable live with Mod+T.
# Frosted-glass terminal
[[window_rules]]
app_id = "Alacritty"
opacity = 0.85
blur = true
# Desktop widget — pinned to the canvas, borderless
[[window_rules]]
app_id = "my-clock"
position = [50, 50]
widget = true
decoration = "none"Tip
To find a window's app_id or title, run driftwm msg state — it lists
every open window with its app ID, title, position, and size.
See docs/window-rules.md for more details.
multi_monitor.mp4
Multiple monitors are independent viewports on the same canvas. An outline on each monitor shows where the other monitors' viewports are. Cursor crosses between monitors freely; dragged windows teleport to the target viewport's canvas position.
Multi-monitor bindings
| Input | Action |
|---|---|
Mod+Alt + arrow |
Send window to adjacent output |
docks.mp4
Layer shell surfaces (waybar, fuzzel, mako) work as expected. Docks and taskbars
see every window — click one and the viewport pans to it and centers it.
Bookmarks are exported as workspaces over ext-workspace-v1 — bars that support
it can list them and click to jump. It's an export for tooling, not real
workspaces; driftwm is still one canvas.
session.mp4
Close a window and leave a placeholder behind instead of losing it:
suspend-window (Mod+Shift+Q) swaps the window for a compositor-drawn
stand-in at the same canvas spot — press Enter or click its name to bring the
app right back, in the same place. suspend_on_close does this automatically
for every client-initiated close. [session].restore_windows keeps your whole
canvas saved as you work and restores it (dormant, nothing auto-launches) on the
next start, with restore_camera bringing each output's view back too.
See docs/session.md.
- New window placement: snapped adjacent to whatever is in view (default), in viewport center, or under cursor
- Click-to-focus (default) or focus-follows-mouse (sloppy focus)
- Hot corners: any keybinding action fires when the cursor reaches a screen corner, configured per monitor
- Cursor edge-pan: push the pointer against a screen edge and the viewport pans, toggled with the
toggle-cursor-panaction - Session lock and idle notification
- Screen capture: screencasting (OBS, Firefox, Discord) and screenshots, incl. built-in canvas/DPI capture
- 40+ Wayland protocols
- IPC control: script the compositor over a Unix socket with
driftwm msg(full command/flag reference: docs/cli.md)
yay -S driftwmor for latest main:
yay -S driftwm-gitA flake.nix is included. To build:
nix buildFor development (provides native deps, uses your system Rust):
nix develop
cargo build
cargo runTo enable driftwm on NixOS, you can import and use the provided NixOS module in your configuration.
Using Flakes:
# flake.nix
{
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
driftwm.url = "github:malbiruk/driftwm";
};
outputs = { self, nixpkgs, driftwm, ... }: {
nixosConfigurations.myHost = nixpkgs.lib.nixosSystem {
modules = [
driftwm.nixosModules.default
./configuration.nix
];
};
};
}Then, enable it in your configuration:
# configuration.nix
{
programs.driftwm.enable = true;
}Without flakes, import the flake's output directly:
let
driftwm-flake = builtins.getFlake "github:malbiruk/driftwm";
in
{
imports = [ driftwm-flake.nixosModules.default ];
programs.driftwm.enable = true;
}programs.driftwm.package selects the package providing the compositor binary.
XWayland via xwayland-satellite is on by default; set
programs.xwayland.enable = false; to disable it.
To enable driftwm using Home Manager, you can import and use the provided Home Manager module in your configuration.
Using Flakes:
# flake.nix
{
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
home-manager.url = "github:nix-community/home-manager";
driftwm.url = "github:malbiruk/driftwm";
};
outputs = { self, nixpkgs, home-manager, driftwm, ... }: {
homeConfigurations.myHost = home-manager.lib.homeManagerConfiguration {
pkgs = nixpkgs.legacyPackages.x86_64-linux;
modules = [
driftwm.homeModules.default
./configuration.nix
];
};
};
}Then, enable it in your configuration:
{
wayland.windowManager.driftwm.enable = true;
}Without flakes, import the flake's output directly:
let
driftwm-flake = builtins.getFlake "github:malbiruk/driftwm";
in
{
imports = [ driftwm-flake.homeModules.default ];
wayland.windowManager.driftwm.enable = true;
}wayland.windowManager.driftwm.package selects the package providing the compositor binary.
XWayland via xwayland-satellite is on by default; set
wayland.windowManager.driftwm.settings.xwayland.enabled = false; to disable it
(and wayland.windowManager.driftwm.xwaylandSatellitePackage = null; to skip installing the package).
The TOML-based configuration is available through wayland.windowManager.driftwm.settings.
Requires Rust 1.88+ (edition 2024).
Install build dependencies:
Fedora:
sudo dnf install libseat-devel libdisplay-info-devel libinput-devel mesa-libgbm-devel libxkbcommon-develUbuntu/Debian:
sudo apt install libseat-dev libdisplay-info-dev libinput-dev libudev-dev libgbm-dev libxkbcommon-dev libwayland-devArch Linux:
sudo pacman -S libdisplay-info libinput seatd mesa libxkbcommonNote
Ubuntu 24.04 ships Rust 1.75 which is too old. Install via
rustup instead of apt install rustc.
Then build and install:
git clone https://github.com/malbiruk/driftwm.git
cd driftwm
make build
sudo make installTo uninstall, run sudo make uninstall from the repository.
Every release carries a driftwm-<version>-vendor.tar.xz asset holding all Rust
dependencies plus the .cargo/config.toml that points at them, for building
without network access:
sha256sum -c driftwm-<version>-vendor.tar.xz.sha256 &&
tar xf driftwm-<version>.tar.gz &&
tar xf driftwm-<version>-vendor.tar.xz -C driftwm-<version> &&
cd driftwm-<version> &&
cargo build --offline --locked --release &&
sudo make installImportant
The vendor tarball has no top-level directory: it unpacks vendor/ and
.cargo/ into whatever directory it is extracted in, hence the -C. Don't
prune vendor/ either — cargo checksums it against Cargo.lock, so dropping
a crate you think is unused, or a file inside one, breaks --offline.
System build dependencies still come from your distro.
driftwm auto-detects whether it's running nested (inside an existing Wayland
session) or on real hardware (from a TTY). Just run driftwm. For display
manager integration, select "driftwm" from the session menu.
mod is Super by default. The terminal is $TERMINAL, else the first of foot,
alacritty, ptyxis, kitty, wezterm, gnome-terminal, konsole; the launcher is
$LAUNCHER, else the first of fuzzel, wofi, rofi, bemenu-run, wmenu-run,
tofi-drun, mew-run. Both are overridable in config.
| Shortcut | Action |
|---|---|
mod+return |
Open terminal |
mod+d |
Open launcher |
mod+q |
Close window |
mod+l |
Lock screen |
mod+ctrl+shift+q |
Quit |
Feature-specific bindings (navigation, zoom, snap) are in their respective sections above.
Nested sessions don't save or restore state
unless you pass --session-file <path>.
Tip
When launched by a display manager, driftwm runs as a systemd user service — view logs with journalctl --user -u driftwm.service (add -f to follow). Run directly and logs go to stderr.
Each of these enables or improves a feature:
xwayland-satellite(≥ 0.7) — X11 app support (see below).xdg-desktop-portal+xdg-desktop-portal-wlr(≥ 0.8.0) orxdg-desktop-portal-cosmic— screencasting, and screenshot apps that go through the portal (e.g. Flameshot). wlr needs a dmenu-style picker in$PATH(wmenu/wofi/rofi/bemenu/mew/fuzzel) to choose what to share.grim+slurp— screenshots (+ cropping to region).adwaita-fonts— renders SSD title bars inAdwaita Sansto match GTK apps; without it a generic sans-serif is substituted. Font, size, weight, and alignment are configurable under[decorations].- A cursor theme — most desktops set one up already; on a bare install driftwm falls back to a basic built-in arrow.
X11 apps run through xwayland-satellite,
which driftwm spawns at startup, exporting DISPLAY=:N so X11 clients connect
transparently — no extra config beyond having the binary in $PATH.
- Arch:
sudo pacman -S xwayland-satellite - Fedora:
sudo dnf install xwayland-satellite - NixOS:
pkgs.xwayland-satellite - Debian/Ubuntu: not yet packaged —
cargo install --locked xwayland-satellite
If satellite isn't found at startup, driftwm logs a warning and continues without
X11 support. You can override the binary path or disable the integration in
config.reference.toml under [xwayland].
Config file: ~/.config/driftwm/config.toml (respects XDG_CONFIG_HOME).
mkdir -p ~/.config/driftwm
cp /etc/driftwm/config.reference.toml ~/.config/driftwm/config.tomlMissing file uses built-in defaults. Partial configs merge with defaults —
only specify what you want to change. Use "none" to unbind a default binding.
Validate without starting: driftwm --check-config.
# Launch programs at startup
autostart = ["waybar", "swaync", "swayosd-server"]Every option is documented in docs/config.md, generated
from config.reference.toml.
driftwm is just a compositor — everything else is standard Wayland tooling. A few ways to get a desktop going on top of it:
extras/ is an installable starting point — a driftwm
config, a Quickshell "home dashboard" (time, battery,
Wi-Fi, Bluetooth, audio, brightness, CPU/RAM, media, tray, power menu) pinned at
the canvas origin, GLSL shader wallpapers, and helper scripts such as a fuzzel
spotlight that searches open windows, suspended windows, and apps together, wired
into a curated setup. Run extras/install.sh to try it, or steal pieces.
Full Wayland shells like noctalia, wayle, and dank-material-shell
are compositor-agnostic and give you a complete desktop out of the box (driftwm
supports the wlr-layer-shell protocol), just without compositor-specific features
— a good newcomer-friendly option.
Or assemble your own from standard pieces:
- waybar — Status bar / taskbar
- crystal-dock — macOS-style dock
- fuzzel / wofi — App launcher
- mako / swaync — Notifications
- swaylock — Lock screen
- swayidle / hypridle — Idle timeout (lock, suspend)
- swayosd — Volume/brightness OSD
- wlr-randr / wdisplays — Output configuration
- COSMIC Settings — Wi-Fi, Bluetooth, sound (or nm-applet + blueman + pavucontrol)
- driftwm-desktop — A layer for displaying
~/Desktopcontents on canvas as draggable icons. - Driftmap — interactive overlay minimap for driftwm
- driftwm-settings — Iced GUI config editor
- DriftGlide — Gesture navigation bar & Circle to Search with Gemini Vision
- driftwm-noctalia — noctalia shell fork adapted for driftwm
- Just Enough Shell — minimal QuickShell desktop shell, driftwm-focused
- Gallery — community shaders & rices, share your own
See CONTRIBUTING.md.
TL;DR: open an issue before writing non-trivial code, keep PRs small and focused.
If you want to support the project (or just want a shirt), this is the way.
XL (other sizes on request)
40 USD
Ships worldwide from Tbilisi.
Order via Telegram, Instagram, or email 2601074@gmail.com.
Revenue goes to me as driftwm's primary maintainer.
GPL-3.0-or-later

