Skip to content
sebastiencsPublic

About

A beautiful, highly customizable tiling Wayland compositor

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

tema

A Wayland compositor written from scratch in Rust, with tiling inspired by bspwm (X11). It speaks the Wayland protocol itself, drives the display through DRM/KMS + GBM, renders with OpenGL ES or Vulkan, and runs its entire event loop (clients, input, udev, D-Bus, DRM) on a single io_uring-driven action dispatcher.

tema running btop, fastfetch, and Alacritty

Status

Work in progress. The core is implemented and the compositor runs real clients (terminals, bars, browsers, screen capture tools), but the project is very young: expect rough edges, missing polish, and breaking changes.
The config format is still evolving.

The essentials are done:

  • Tiling, floating and fullscreen windows
  • Multi-output with hotplug
  • Layer-shell panels and bars
  • Screen capture / sharing
  • Clipboard managers and idle daemons
  • Session locking

Features

Rendering

  • Hardware-accelerated rendering with two backends: OpenGL ES and Vulkan
  • Renderer selectable per GPU device (opengl, vulkan, or auto)
  • Variable Refresh Rate (VRR) (tested on 240hz monitor)
  • Direct DRM/KMS atomic modesetting, GBM buffer allocation, dmabuf import
  • SDR color management (wp_color_manager_v1) and color representation (wp_color_representation_manager_v1: alpha mode, YCbCr coefficients, chroma siting)
  • Explicit synchronization (linux-drm-syncobj) and incremental damage tracking (FB_DAMAGE_CLIPS, buffer age, occlusion)

Effects & animations

  • Cool animations: custom bezier curves, popin/slide/fade styles for windows and workspace transitions
  • Blur, shadows, gradient borders with corner rounding
  • Inactive-window dimming and opacity

Waybar

ext-workspace id is the workspace stable id (workspace-1, workspace-2, …), the same string the IPC snapshot uses. Waybar's default ext/workspaces sort compares that string, so workspace-10 comes before workspace-2. Set "sort-by-coordinates": true on the module to follow workspace order instead.

Build & run

Requires a Rust nightly toolchain and libshaderc_shared.so (the shaderc package on most distros).

cargo build --release

Run from a TTY inside a logind session:

./target/release/tema

Configuration

The compositor reads ~/.config/tema/config.toml and reloads it on save.
See config.toml.example for all options

License

Licensed under the BSD 3-Clause License.

About

A beautiful, highly customizable tiling Wayland compositor

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages