No description
  • Rust 98.6%
  • GLSL 0.9%
  • Nix 0.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-12 19:49:47 -07:00
resources fix: stop nixos-rebuild from stopping hummingbird 2026-10-11 20:33:10 -07:00
src feat: cluster solve cache 2026-11-12 19:49:47 -07:00
tests/integration fix: maximization alignment issues 2026-11-12 05:27:58 -07:00
.envrc chore: initial commit 2026-10-04 04:32:11 -07:00
.gitignore chore: more setup 2026-10-04 05:24:08 -07:00
AGENTS.md chore: AGENTS.md 2026-10-08 12:43:39 -07:00
Cargo.lock feat: improve reliability 2026-11-05 03:41:13 -07:00
Cargo.toml feat: improve reliability 2026-11-05 03:41:13 -07:00
flake.lock chore: initial commit 2026-10-04 04:32:11 -07:00
flake.nix chore: some test tuning 2026-11-10 01:33:29 -07:00
justfile chore: more setup 2026-10-04 05:24:08 -07:00
LICENSE chore: license 2026-10-13 22:58:49 -07:00
README.md chore: update readme 2026-11-10 02:01:54 -07:00

Mosaic

Mosaic is an experimental clustering Wayland compositor built on Smithay, focused on usability and consistent desktop interactions.

Clustering is a spatial windowing model where windows are automatically arranged around a center point, and positions are determined by window-to-window relationships. This allows for great flexibility while requiring minimal user effort in managing windows. Each cluster acts as it's own workspace, and they're automatically moved to make space when their neighbors grow.

Any layout that is possible in multiple workspaces in other scrolling (eg. Niri) or tiling window managers is also trivially possible in Mosaic in one cluster (workspace).

Unlike other two-dimensional/spatial compositors (newm, driftwm, etc), Mosaic is designed to work well with any mouse input method, including mice, touchpads, and trackballs.

Warning

Mosaic is unfinished experimental software in early development. While I do daily drive it, you should expect bugs and unfinished features. There are several critical missing features I plan to add in future versions:

  • A more logical way to resize windows using a trackpad.
  • Alt + Tab.
  • Screen recording in the screenshot overlay.

Features

  • Full Xwayland support
  • Pipewire screen capture (requires fuzzel to be installed for now)
  • Screenshot interface with window/selection/screen modes
  • Overview with multi-window selection
  • Minimap
  • Trackpad gestures

Installation

The only supported way to install Mosaic for the time being is to use the Nix flake. A justfile that installs the compositor to the system is provided for testing and development. I haven't written packaging for any other distro (and I'm unsure if I will right now).

Usage

Configuration

Mosaic can be configured using a TOML configuration file in $XDG_CONFIG_HOME/mosaic/config.toml. The default configuration (with comments) is available in src/config/default.toml.

With Home Manager, import inputs.mosaic.homeModules.default and set the config through programs.mosaic.settings:

programs.mosaic = {
  enable = true;
  settings.canvas.gap = 12;
};

(Important) Default Keybinds

  • Super: open/closes the overview.
  • Super Super: opens the cluster overview.
  • Super+Q: closes the focused window.
  • Super+Shift+E: exits the compositor.
  • Print: opens the screenshot overlay.
  • Super+F: maximizes the focused window.
  • Super+LMB: moves the clicked window.
  • Super+RMB: resizes the clicked window.
  • Super+Shift+Left: pans the screen. Tapping Super+Shift+Left and quickly moving the mouse in a direction will move the screen in that direction, snapping to the nearest window. Holding Super+Shift+Left will pan the screen continuously until released.

Default Gestures

Gestures are enabled by default.

  • 3 finger swipe: pans, snapping to nearby windows.
  • Super + 2 finger pinch: zooms the screen in/out.
  • 4 finger swipe up/down: opens/closes the overview. Repeating this action will toggle between the overview and the cluster overview.

The Overview

The overview zooms the screen out to fit all open windows in the cluster. While in the overview, you can click on windows to switch to them, or drag them around to rearrange them. Additionally, dragging on the background or the gaps in between windows will allow you to select multiple windows (so will Ctrl and Shift), and dragging on the selected windows will move them. You can also close all selected windows by clicking the close button on a selected window.

The cluster overview allows you to switch between clusters and move them.