0-ss / MacShell

MacShell 
 A macOS Tahoe–style menu bar + Dock for Hyprland, built on Quickshell , 
 with a real-time Liquid Glass refraction shader, and a lock screen, MacLock .
 Quick showcase (OLD) 
 Screenshots ·
 Requirements ·
 Install ·
 Updating ·
 Hyprland config ·
 MacLock ·
 Troubleshooting 
---
A macOS Tahoe–style **menu bar + Dock** for Hyprland, built on Quickshell, with a real-time
"Liquid Glass" refraction shader, window previews, Spotlight, clipboard/emoji picker, notifications, Control Center,
screenshots, screen recording, desktop widgets (weather, calendar, clock, music player), a wallpaper picker, an
Alt+Tab switcher and a full lock screen, all in one Quickshell process.
The repository also ships **MacLock**, a matching Liquid Glass lock screen. It is a separate Quickshell config on
purpose: it runs as its own process, so a shell crash can never take the lock with it.
Best icon pack for the shell: https://github.com/Scrimas/MacOS-Like
> **Heads up:** this targets **Hyprland 0.55+ with a Lua config** (`hyprland.lua`) and a recent **Quickshell (0.3.x)**.
> See Requirements and Known issues.
## Screenshots
### MacShell
**The whole desktop:** widgets, the menu bar on top and the Dock at the bottom.
**The Dock,** with Liquid Glass.
**Control Center**
### MacLock
 Lock screen 
 Lock screen media player 
## Files
 [code] 
The two are installed as **separate** Quickshell configs (neither lives inside the other).
**MacShell**
| File | Purpose |
|---|---|
| `shell.qml` | Entry point. Shared hub: window geometry, wallpaper lookup, capture gating. |
| `MacBar.qml` | Menu bar, Control Center, Spotlight, notifications, switcher, screenshots, wallpaper picker. |
| `MacDock.qml` | Dock, window previews, and the Settings window. |
| `ClockApp.qml` | The Clock app window (opened from the menu bar clock). |
| `MacWidgets.qml` | Desktop widgets layer (data, placement, editing). |
| `WidgetVisual.qml` | Draws one widget; shared by the desktop layer and the Liquid Glass backdrop, so menus refract the widgets too. |
| `WeatherWidget.qml`, `WeatherIcon.qml`, `WeatherHourCol.qml`, `CalendarWidget.qml`, `ClockWidget.qml`, `PlayerWidget.qml`, `PlayerArt.qml`, `PlayerBtn.qml`, `PlayerGlyph.qml`, `ImageWidget.qml`, `MarqueeText.qml` | The widgets and their helpers (`ImageWidget.qml` shows a picture of your choice). |
| `SPopUp.qml`, `Dissolve.qml`, `MorphText.qml`, `MorphGlyph.qml`, `WGlyph.qml`, `ClockGlyph.qml`, `Wheel.qml` | Shared UI pieces and effects. |
| `liquidglass.frag` (+ `contourglow`, `tintcard`, `dust`, `burn`, `fade`) | Shaders. Prebuilt `.frag.qsb` files ship next to them; `liquidglass.frag` is recompiled with `qsb` on first run. |
| `EmojiData.js` | Emoji fallback data for Spotlight (from gemoji, MIT). |
| `macshell-update` | Update tool (installed to `~/.local/bin`, see Updating). The installer also writes `macshell-start`, the script the Hyprland autostart runs. |
| `apple-logo-black.svg`, `apple-logo-white.svg` | Menu bar logo. |
| `assets/` | Icons