Skip to Content
MvpDots

Introduction

MvpDots is a complete macOS-style desktop for Hyprland 0.55+, installed with one command.

Two tiled terminals in mauve: system information on the left, the Hyprland Lua config on the right

MvpDots turns a fresh Arch-based install into a finished desktop: a shell written from scratch in Quickshell (bar, Dynamic Island, dock, Spotlight, Control Centre, Settings, lock screen), a Hyprland config in Hyprland's new Lua language, and one colour palette, taken from your wallpaper, applied to everything.

New to Hyprland?

Hyprland is a tiling Wayland compositor: windows are arranged next to each other automatically instead of overlapping. MvpDots keeps that, and adds everything people miss coming from macOS or Windows: a dock, a launcher, a control centre, a settings app and familiar shortcuts.

What you get

How to read these docs

Get started: Installation → Your first login. About ten minutes.

Use the desktop: Shortcuts, then one page per feature. Each page says what the feature does, how to use it, how it works (with the real code) and how to change it.

Make it yours: Customise and the Reference. Every change is shown as a diff, so you see exactly which lines move.

Built with

PartProgramWhy this one
CompositorHyprland ≥ 0.55Smooth animations, and a Lua config the Settings app can safely write to
SessionuwsmStarts Hyprland as a proper systemd session, so services get the right environment
ShellQuickshell ≥ 0.3 (QML)One process for bar, island, dock, panels and lock screen
ColoursmatugenMaterial You palettes from any image, one template per app
WallpaperawwwAnimated wallpaper changes, restores the last one at login
Terminal · filesGhostty · YaziFast, themeable, and Ghostty reloads colours live

On this page