Home

Mist wiki

Mist is a macOS-style desktop shell for Hyprland, written in Rust. Every surface (bar, dock, Dynamic Island, desktop cards, panels) is drawn on the CPU into wl_shm buffers; only the live wallpaper uses the GPU.

Start here

1. Installation: package or checkout, Hyprland config, fonts.
2. Keybindings and IPC: the keys, and mist-ui-bin msg for scripting everything.
3. Desktop and cards: the clock, weather, Garmin and running cards, Customise desktop.
4. Configuration: what lives in ~/.config/mist/.

Topics

Page
Wallpapers	photos, live GLSL scenes, the weather sky
Phone	KDE Connect, calls through ADB
Languages and monitors	UI language, which monitor gets the dock and desktop
Troubleshooting	logs, the guard, blur, fonts, crashes
Architecture	processes, IPC, performance rules
Development	build, tests, offscreen checks, translations, CI
FAQ

The reference documents live in the repository and are the source of truth: README, docs/CONFIG.md, docs/BENCHMARKS.md, native/README.md.