Skip to content
NewPlugins now rebuild themselves after Hyprland updates

A macOS-style desktop for Hyprland

Dynamic Island, Spotlight, Mission Control, Liquid Glass and colours taken from your wallpaper. A shell written from scratch in Quickshell, configured in Hyprland’s Lua, installed with one command.

Built onHyprlandArch LinuxQt / QMLLuaWayland
Two tiled terminals in mauve: system information on the left, the Hyprland Lua config on the right
// What you get[ 01 ]

Everything a desktop needs,already put together

One shell for the bar, the island, the dock and every panel. Each part has a page in the docs: its shortcut, what it does, the code and how to change it.
A notification inside the Dynamic Island: “Build finished”

Dynamic Island

Volume, messages, music and the calendar all grow out of one capsule in the bar. Spotlight and Control Centre open inside it too.

RAM in use
The whole shell220 MB
Hyprland75 MB
Wallpaper + idle6 MB
220 MB

For the bar, island, dock and every panel. About 1 % CPU at idle.

Spotlight

Apps, maths and units, files, settings and the web.

Spotlight converting 5 km to miles: 3 mi + 188 yd

Colours from the wallpaper

matugen repaints the shell, GTK, Qt, the terminal and the borders.

Your habits, kept

ApplicationsWin
SpotlightWin+Space
Switch windowsAlt+Tab
SnipWin+Shift+S
Settings, Liquid Glass: style, frost, refraction, edge glow and where the glass appears

Liquid Glass, tuned in Settings

Frost, refraction, edge glow, and where the glass appears.

The power menu: lock, suspend, reboot, shut down and log out

Lock, sleep, restart

The power menu on Win+X or Ctrl+Alt+Del, over a blurred desktop.

// The island[ 02 ]

One capsule that turnsinto what you need

Pick a state to see it on the desktop.

The Dynamic Island showing a notification at the top of the screen
A notification, dismissing itself

Notifications

Messages slide out of the island

Win+N all notifications

“A banner grows out of the capsule, waits a moment, and tucks itself back in.”

A notification grown out of the Dynamic Island
Whole shell220MB
CPU at rest1%
Audio spectrum, only while expanded16 bars
// The dock[ 03 ]

Out of the way,until you need it

A macOS dock that knows when to get out of the way. Try it: open a window on the desktop to the right.

  • Hides only when it would be coveredAn empty desktop keeps it on screen; a window over it sends it away.
  • Magnifies under the pointerRunning apps get a dot underneath.
  • Minimised windows after the dividerClick one to bring it back where it was.
Terminal
Files
Browser
Settings
Minimised: Screenshot
// The pieces[ 04 ]

Open any partof the shell

Every panel is a few keys away and has a page in the docs. Pick one to see what it does.
The Applications grid with category tabs and search
Shortcut Win

Tap Win and every app is there, sorted into tabs. Start typing to filter, or pick a tab.

Read how it works
Shortcut Win+A

Wi-Fi, Bluetooth, sound in and out, brightness, night light, keep awake and power mode. It grows out of the island instead of opening a window.

Read how it works
Shortcut Win+Tab

Every desktop as a thumbnail, the current one spread out with live previews. Click to focus, drag to move a window, middle-click to close it.

Read how it works
Shortcut Win+Shift+T

Draw a box around any text on screen and it lands on the clipboard. The screenshot toolbar next to it does region, window, screen and recording.

Read how it works
Colours

Change the wallpaper, the whole desktop follows

Pick a palette and watch it travel: from the image, through matugen, into every app. Each one is a real run on the desktop.

Wallpaper
Mauve (fixed accent) wallpaper
$ setaccent "#cba6f7"
matugen
tonal palette
Shell
GTK 3 / 4
Qt / Kvantum
Ghostty
Hyprland
Starship
btop · cava
The desktop themed by Mauve (fixed accent): Control Centre open
Shortcuts

Point at a key, see what it opens

Windows habits for windows, macOS features for everything else. Win+/ shows all of them on the desktop.

The Applications grid opened by tapping the Win key, with category tabs and search
// Under the hood[ 07 ]

A laptop that ishard to break

The Laptop Config is the system underneath: snapshots you can boot into, compressed disk and memory, a GPU that sleeps until it is needed, and dual boot with a shared drive.
The Liquid Glass boot menu: frosted glass over a mauve and blue wallpaper, with EndeavourOS, Fedora, Ubuntu and Windows entries
The Liquid Glass boot menu: frosted glass over a mauve and blue wallpaper, with EndeavourOS, Fedora, Ubuntu and Windows entries
Boot menuLiquid Glass, for GRUB./install.sh --grub
Boot into yesterdaygrub-btrfs
EndeavourOS
Snapshots ›
#14 pacman -Syu
#13 pacman -S docker
#12 timeline

A snapshot before every package change. Pick one in the boot menu and the laptop starts as it was.

8snapshots kept, plus 5 daily
2kernels: zen and LTS
20%of RAM max for zswap
One Btrfs partitionzstd:1
@/
@home/home
@snapshots/.snapshots
@log/var/log
@cache/var/cache
@swap/swap
Files6.9 GB
On disk, compressed4.1 GB
The NVIDIA GPU sleepsRTD3
desktopIntel
NVIDIAasleep

❯ prime-run game
wakes it only for that app

Memory that compresseszswap
20%

At most a fifth of RAM holds compressed pages (zstd), so idle apps shrink instead of going to disk.

swappiness 100 · page-cluster 0

// Versus macOS[ 08 ]

My laptop beatsmacOS too

With this setup, my mid-range laptop does more than macOS offers: faster, lighter on disk, safer to update and quicker to work in. Here is how, side by side.
220 MBRAM for the whole desktop shell
1 %CPU at idle, measured
41 %disk saved by compression (6.9 → 4.1 GB)
SpeedmacOS: Animations you can reduce but not tune, and background services you cannot remove.MvpDots: Snappy by default; panels exist only while they are open, and Eco look turns every effect off with one key.
Undo a bad updatemacOS: Time Machine to another drive, and a recovery boot to go back.MvpDots: A Btrfs snapshot before every package change, each one bootable straight from the boot menu.
StoragemacOS: Files take the space they take.MvpDots: Transparent zstd compression: the same files use about 41 % less disk.
HardwaremacOS: Only on Apple hardware.MvpDots: Runs on the laptop you already have; the NVIDIA GPU sleeps until a game or app asks for it.
Getting work donemacOS: Windows overlap; tiling needs extra apps.MvpDots: Tiling and floating windows, Spotlight, Mission Control, a Dynamic Island and Windows-style keys.
Making it yoursmacOS: What Apple allows.MvpDots: Every pixel: glass, corners, gaps, dock, shortcuts and colours from any wallpaper, from a Settings app.
CostmacOS: Part of the price of a Mac.MvpDots: Free and open source.

Measured on my own laptop (12th-gen Intel i5, 16 GB RAM, RTX 2050), compared with what macOS ships. Your hardware will differ.

// Install[ 09 ]

One command.A backup of everything.

It asks before anything optional or anything that needs sudo. Change your mind later? ./uninstall.sh puts your old setup back.
  1. 01Clone it and run the installerPackages for your distro, the configs, the wallpapers and the colours, then the user services.
  2. 02Your old configs are saved firstEverything it would replace goes to ~/.local/state/dotfiles/backup-<date>/ before a single file is copied.
  3. 03Log out and pick HyprlandChoose “Hyprland (uwsm-managed)” on the login screen. Plugins build for your exact Hyprland version.
  4. Installation guide
git clone https://github.com/subhadeeproy3902/dotfiles.git && cd dotfiles && ./install.sh
./install.sh --yes

❯ ./install.sh --yes

Desktop installer — EndeavourOS

✓==> Packages 73 from the official repos, 2 from the AUR

✓==> Configs previous files backed up to ~/.local/state/dotfiles/

✓==> Wallpapers colours built from the first one

✓==> User services shell, wallpaper, clipboard, idle, polkit

✓==> Plugins 4 built for Hyprland 0.56.2

Done. Log out and pick “Hyprland (uwsm-managed)”.

Arch, EndeavourOS, CachyOS, ManjaroFull: everything from the official repos, plus 2 AUR packages
Ubuntu 25.10, 26.04 LTSSupported: Hyprland and Quickshell from two PPAs the installer adds
FedoraExperimental: Hyprland and Quickshell from COPR
Any other distroThe configs install anywhere with Hyprland 0.55+ and Quickshell 0.3+
// FAQ[ 10 ]

Good questions,straight answers

Still stuck?

Every part of the desktop has its own page: what it does, its shortcut, the code and how to change it.

No. It installs as its own session next to GNOME, KDE or whatever you use; you pick it on the login screen. Every config file it replaces is backed up, and ./uninstall.sh puts them back.

Arch, EndeavourOS, CachyOS and Manjaro fully. Ubuntu 25.10 and 26.04 LTS through two PPAs (the installer adds them). Fedora works through COPR and is experimental. Anywhere else the configs install once you have Hyprland 0.55+ and Quickshell 0.3+: ./install.sh --doctor lists what is missing.

Yes. Use VMware Workstation or VirtualBox 7 with 3D acceleration turned on, give it 2+ CPU cores and 4 GB of RAM, install Ubuntu 26.04 LTS and run the installer. Answer No to the plugins question; without a real GPU, Eco look (Win+Alt+G) keeps it smooth.

Not the desktop: the config is plain Hyprland Lua. The optional plugins rebuild themselves at the next login for the new version, using the same version pins as Hyprland’s own plugin manager, and anything Hyprland refuses to load is skipped.

About 220 MB of RAM and around 1 % CPU for the whole shell (bar, island, dock and every panel) on a 12th-gen i5. Panels exist only while open, and everything pauses on the lock screen.

No. It was built on a laptop that draws the desktop with integrated Intel graphics while the NVIDIA GPU sleeps. Liquid Glass is optional; Eco look (Win+Alt+G) turns off blur, shadows and animations in one key press.

Most things: Settings (Win+I) covers glass, gaps, corners, animations, the dock, hot corners, accent colours, fonts and shortcuts. Your own Hyprland lines go in ~/.config/hypr/user.lua, which updates never touch.