6 modules
Bar
Workspaces, media, tray, clock, notifications and system, each a pill that opens into a panel. Float them as islands, or sit them in a notch flush with the screen edge.
v1.1.0Lock screen, polkit, accounts and light mode
A whole desktop, themed from your wallpaper.
Lucid is a Material 3 Expressive shell for Hyprland, built on Quickshell. A bar, a dock that grows into a launcher, desktop widgets, a lock screen and a settings app, all wearing the colours of whatever is on your screen.
$ git clone https://github.com/Sn3akyy1/lucid.git && cd lucid && ./install.sh
170 stars
6 forks
Arch Linux and Hyprland
Announcements
News from Lucid.
New releases, what is coming next, and anything else worth knowing. When a version lands, the shell tells you itself, in a notification just like this one.
What's in it
Everything a desktop needs, in one design language.
Every surface shares one palette, one set of motion curves and one settings app. The bar, the dock and the lock screen look like they came from the same place because they did.
System pill
Control centre
Wi-Fi and Bluetooth with full panels behind them, brightness, volume and audio device switching, then battery, RAM, CPU and every disk.
Scratchpads
Special workspaces
Music, chat and your to-do list slide over whatever you are doing and hide again with the same key. Each one starts its app if it isn't running.
- Music Super+Shift+M
- Comms Super+Shift+D
- To-do Super+Shift+R
- System monitor Ctrl+Shift+Esc
6 modes
Dock and launcher
A floating toolbar that grows into the launcher instead of opening a second window over it. One search field over apps, commands, themes, wallpapers, power and clipboard history. Type = for a calculator.
11 kinds, 33 looks
Desktop widgets
Clocks, calendars, weather, media, a live visualiser, notes, to-dos and your phone. Drag them anywhere, snap to the guides, and they come back where you left them.
17 pages
Settings
A GUI for all of it, down to your network, Bluetooth, displays, idle ladder, user accounts and phone. Every control shows a reset arrow once it moves off its default.
Session lock
Lock and login
A real session lock that checks your password through PAM and counts your tries against faillock, with a matching login screen for SDDM.
- PAM
- faillock countdown
- Caps Lock badge
- Polkit prompts
- SDDM theme
Theming
Seven palettes, or your wallpaper's own.
Matugen and Pywal build a Material 3 palette from your wallpaper. Catppuccin Mocha, Gruvbox, Nightfox, Nord and Tokyo Night stay put. Every one of them has a light mode.
- Change the wallpaper, change the desktop. The shell reads one file of Material 3 colour roles, and it is rebuilt whenever you pick a new picture.
- Light mode is built, not inverted. Nord lands on its own Snow Storm, Gruvbox on its own cream, and light surfaces carry a trace of the accent.
- Bring any scheme. Paste the URL of a colour-scheme repo into Settings → Theme and Lucid builds a full palette from it. Nothing from the repo is ever run.
- It reaches past the shell. Kitty, the starship prompt, VSCodium and the login screen take the same colours, and GTK and Qt apps follow light or dark.
Theme
The same controls as Settings → Theme, running on the palettes the shell ships. Your pick sticks, on every page, until you change it.
Light or darkRe-derives the palette from your wallpaper in the mode you pick.
Colour schemeSwitching repaints this page in that palette.
Palette widgetThe card you can put on your desktop. Click a colour to copy its hex.
Matugen
Install
Three commands on Arch Linux.
The installer checks your system, asks before it installs anything, and backs up whatever it replaces.
$ git clone https://github.com/Sn3akyy1/lucid.git
$ cd lucid
$ ./install.shThen run hyprctl reload, or log out and back in. On first run, set a wallpaper from Settings → General. That is what generates your palette.
- Checks your systemRefuses to run anywhere it can't finish the job, rather than leaving you half-installed.
- Installs dependenciesUses paru or yay, falls back to pacman, and lists everything before it touches your system.
- Copies the shellTo
~/.config/quickshell, moving any existing config aside with a timestamp first. - Sets up HyprlandKeybinds, window and layer rules, blur, animations and an autostart. It asks before replacing your config.
- Sets up themingThe palettes, the wallpaper hook and the matugen template, appended to your matugen config, never replacing it.
- Applies the lookKitty, starship, the VSCodium theme and the GTK theme.
--no-lookskips all of it. - Pins the dockReads your installed apps, so the dock is never a row of blank tiles.
- Offers to restartA running shell moves onto the new files.
Keyboard first
Tap Super. Everything else is a chord away.
The installer ships a full set of binds. If you'd rather write your own, every surface can be driven with qs ipc call.
Launcher
Super tapCommand palette
Super+PWorkspace overview
Super+WSettings
Super+SEmoji picker
Super+.Clipboard history
Super+Shift+VCopy text off the screen
Super+Shift+TOn-screen keyboard
Super+K
Help
Stuck on something?
Help Center
Fixes for the problems people hit most: choppy animations on NVIDIA, another daemon stealing notifications, a grey palette, blur that frosts your windows.
Search answersReport a bug
Fill in a short form and open a GitHub issue that already holds your versions, your steps and your log.
Build a reportWhat's new
v1.1.0 brought a PAM lock screen, Lucid's own polkit agent, user accounts, a login screen and a real light mode.
Read the changelog