Bring a little Tahoe to your Linux desktop.
A macOS Tahoe-inspired theme for KDE Plasma 6.6 and 6.7+, with liquid glass, a top menu bar, a Dock, matching app themes, sounds, and a boot screen. Pick the parts you like in the installer.
Caution
This project is experimental and under active development. Don't use it on a production system yet. KDE, KWin, or Kvantum updates may temporarily break parts of the theme; running sudo ./install again usually restores them. If something goes wrong, please open an issue.
Find an app with a quick search, keep your favorites close, or browse with a choice of two views.
Your apps sit on a glass Dock that refracts the wallpaper, with hover zoom and notification badges to show what needs your attention.
Give Nautilus a familiar Finder feel, with a macOS-style sidebar and a simpler toolbar in both light and dark modes.
Keep the system menu, active app name, and window controls together in the top bar, with app menus available for applications that support the global menu.
Check your computer's details in a glass window that fits the rest of the desktop.
Even the desktop's right-click menu gets the glass treatment, with a translucent background and blur.
An Apple-style logo sits at the center of each monitor, scaling to fit displays from 1080p to 4K. A progress bar appears during startup; shutdown and reboot keep the same layout without it. If your disk uses LUKS2 encryption, Plymouth shows a masked passphrase field below the logo.
Open the graphical installer and choose what you'd like to install or remove:
./installerFor the same choices in a terminal wizard:
sudo ./install
sudo ./uninstallBoth installers show live progress and support English, Spanish, and Simplified Chinese. Run sudo ./install --help for all options.
Requirements
- KDE Plasma 6.6+
- Python 3.10+
sudo- Qt 6 development tools
- KDE and Qt 6 development packages for the compiled plasmoids and KWin effects
cmake,g++, andpkg-configwhen compiled features are selecteddbus-sendsystemctlorcrontabfor scheduled features
Theme assets are bundled. The optional KDE Rounded Corners effect needs an internet connection; the rest installs without it.
| Distro | Qt 6 tools | KDE Plasma 6 development packages |
|---|---|---|
| Arch family | pacman -S qt6-tools |
pacman -S extra-cmake-modules plasma-workspace kdecoration libplasma libnotificationmanager libksysguard plasma-activities-stats |
| Gentoo | emerge dev-qt/qttools:6 |
emerge kde-frameworks/extra-cmake-modules kde-plasma/plasma-workspace kde-plasma/kdecoration kde-plasma/libplasma kde-plasma/libnotificationmanager kde-plasma/libksysguard kde-plasma/plasma-activities-stats |
| Fedora family | dnf install qt6-qttools-devel |
dnf install extra-cmake-modules plasma-workspace-devel kdecoration-devel libplasma-devel knotifications-devel libksysguard-devel kf6-plasma-activities-devel |
| openSUSE Tumbleweed | zypper install qt6-tools-devel |
zypper install extra-cmake-modules plasma6-workspace-devel kdecoration-devel libKF6Plasma-devel libnotificationmanager6-devel libksysguard6-devel libKF6PlasmaActivitiesStats6-devel |
Choose features and theme mode
Any flag skips the terminal wizard. Use --no-<name> to leave out a component, or --only to install or remove selected components:
sudo ./install --no-gtk --no-sddm
sudo ./install --only --fonts --icons
sudo ./uninstall --only --cursorsAvailable feature names:
wallpapers, fonts, cursors, plasma-theme, window-decorations, kvantum, color-schemes, icons, plasmoids, globalmenu, acrylic-glass, rounded-corners, global-theme, layout, sounds, gtk, firefox, sddm, apps, nautilus, nautilus-bookmarks, portals, oled-care, plymouth.
Choose the initial theme mode:
sudo ./install # automatic light/dark schedule
sudo ./install --light
sudo ./install --darkSwitch later with:
mac-tahoe-theme-switch light
mac-tahoe-theme-switch dark
mac-tahoe-theme-switch autoSave or reset installer choices:
sudo ./install --no-gtk --dark --save
sudo ./install --resetUseful maintenance options:
--preflightchecks the system without installing.--no-apply-themestages files without switching the desktop.--no-grub-modifyleaves/etc/default/grubunchanged.- Theme changes keep any wallpaper you've chosen for each monitor.
--reset-wallpapersreturns all monitors to the bundled light/dark wallpapers../legacy-installand./legacy-uninstalluse the classic prompt instead of the terminal wizard.
Glass and rounded-corner troubleshooting
VirtualBox VM surfaces are excluded from Acrylic Glass in v0.53.0 to prevent glass from filling fullscreen or seamless windows. The VirtualBox manager keeps its normal appearance (#90).
If small triangles appear at window corners with both effects enabled, open
System Settings → Window Management → Desktop Effects → Acrylic Glass
and adjust the window, dock, and popup corner radii. Setting them to 28
resolved the reported case. Starting with v0.53.0, reinstall preserves these
adjustments. The effects retain independent defaults; this release does not
automatically change existing radii (#89).
The desktop-edit overlay reported with ShapeCorners remains under investigation. Disabling KDE Rounded Corners in Desktop Effects was the reporter's workaround (#77).
Firefox theme and profile safety
The Firefox theme works with native, Flatpak, and Snap profiles. Your browser data and existing customizations are preserved. Restart the browser to see the changes.
UI settings are backed up before changes, and uninstall removes the theme's additions. Backups remain in ~/.local/state/mac-tahoe-liquid-kde/firefox/snapshots/ for recovery.
OLED care
OLED care is off by default. Enable it in the graphical feature picker or from the command line:
sudo ./install --oled-care
sudo ./install --oled-care --save
sudo ./install --no-oled-care
sudo ./install --oled-care --oled-interval=3 --oled-max-shift=4Manual controls:
mac-tahoe-oled-care shift
mac-tahoe-oled-care restore
mac-tahoe-oled-care statusTest in a virtual machine
Try the theme in a disposable Plasma VM:
./vm <os>Choose your OS: cachyos · arch · manjaro · endeavouros · garuda · fedora · nobara · opensuse · neon · gentoo · gentoo-openrc
Use all to launch every distro.
Distributions
| Name | Status | |
|---|---|---|
| CachyOS | ||
| Arch Linux | ||
| EndeavourOS | ||
| Fedora | ||
| Manjaro | ||
| Artix Linux (OpenRC) | ||
| Garuda Linux | ||
| Nobara | ||
| openSUSE Tumbleweed | ||
| Gentoo | ||
| KDE neon |
Init systems
| Init system | Support | Testing |
|---|---|---|
| systemd | Supported | Completed |
| OpenRC | Supported | In progress |
Artix uses the Arch package mappings even when its os-release omits
ID_LIKE=arch. Dependency installation, all three C++ builds, the full test
suite, and crontab operations have been checked in an Artix OpenRC container.
Live installation testing is still needed; Artix is not yet included in the
automated container matrix. Scheduled theme changes and OLED care use
the existing per-user cron support and require a running cron daemon.
Plasma versions
| Plasma | Support | Since |
|---|---|---|
| 6.5 and older | Not supported | Not applicable |
| 6.6 | Supported | v0.1.0 |
| 6.7+ | Supported | v0.19.0 |
Chromium-based app crashes with Global Menu
A GTK3 module lifetime defect causes the startup crash reproduced from
issue #81.
The affected Chromium startup code clears gtk-modules after GTK initializes.
Older appmenu-gtk-module builds then unload while their D-Bus callbacks and GTK
menu hooks remain registered. The next callback crashes the app. Upstream
addresses this by making the module resident.
The Global Menu installer now adds a Plasma login hook that includes the
installed module in GTK3_MODULES. GTK retains this startup reference for the
application's lifetime, including across light/dark switches. Existing module
choices are preserved, and the protection keeps GTK global menus available.
Run sudo ./install with Global Menu selected, then log out and back in.
The hook lives at
${XDG_CONFIG_HOME:-$HOME/.config}/plasma-workspace/env/mac-tahoe-gtk-appmenu.sh;
uninstall removes the project's hook. A fresh login is also required after
removal, because existing processes retain their startup environment.
To test one app before logging out, replace your-application below with its
executable:
env GTK3_MODULES="${GTK3_MODULES:+$GTK3_MODULES:}appmenu-gtk-module" your-applicationBoth reported ChatGPT builds, 26.831.21537 and 26.901.51231, were tested with fresh isolated profiles: each crashes without the hook and opens a visible window with it. GDB traces match both application offsets in the report. See the validation record and repeatable probes for the tested environment and scope. Avoid removing the module from live GTK settings: that can itself trigger the unload defect in running apps.
Still to come: icon polish, broader distro testing, and more app themes and widgets.
Open the full roadmap
| Component | Description | Status |
|---|---|---|
| Color Schemes | Light and dark colors that carry across the desktop | Available |
| Wallpapers | Bundled Tahoe Iridescence and Landscape wallpapers | Available |
| Fonts | SF Pro Display, Text, Rounded, and Mono | Available |
| Cursors | Tahoe-style pointers to match the desktop | Available |
| Plasma Theme | Glass panels and desktop menus | Available |
| Kvantum Theme | A matching look for Qt apps in light and dark modes | Available |
| GTK Theme | Matching themes for GTK 2, 3, and 4 apps | Available |
| Acrylic Glass | Blur and wallpaper refraction for the glass look | Available |
| KDE Rounded Corners | Rounded window corners | Available |
| Auto Theme Switcher | Light at 06:00, dark at 18:00, while keeping wallpapers you choose | Available |
| OLED Care | Small, optional panel shifts to help reduce burn-in risk | Available |
| Installer UI | Choose what to install or remove in a graphical window | Available |
| Installer TUI | Make the same choices in the terminal and follow live progress | Available |
| Localization | Installers and widgets in English, Spanish, and Simplified Chinese | Available |
| Aurorae Decorations | macOS-style title bars and window buttons | Available |
| Global Menu | Menus from compatible apps in the top bar | Available |
| Dock Task Manager | Your pinned apps, hover zoom, and notification badges | Available |
| Nautilus | A Finder-style layout for browsing your files | Available |
| Launcher | Search for apps or browse the grid | Available |
| Trash | Open or empty the Trash from the Dock | Available |
| Sounds | Matching notification and system sounds | Available |
| Boot Screen | A logo on every monitor, a progress bar, and a masked LUKS2 unlock prompt | Available |
| Shutdown Screen | The same splash during shutdown and reboot, without the progress bar | Available |
| Firefox Theme | Matching browser styling, with backups and cleanup for each profile | Available |
| Icons | Light and dark icons are bundled; coverage and consistency still need polish | In progress |
| Multi-Distro Support | More desktop testing across the listed distros, including KDE neon | In progress |
| OpenRC Testing | Scheduled theme changes and OLED care on OpenRC | In progress |
| Konsole Theme | A terminal profile that matches the desktop | Planned |
| Kate Theme | Matching colors for the text editor | Planned |
| SDDM Theme | A matching login screen | Planned |
| Calendar | A calendar you can open from the top bar | Planned |
| Control Center | Quick access to common desktop settings | Planned |
| System Preferences | A macOS-style launcher for system settings | Planned |
| OS Selector | A boot menu for choosing your operating system | Planned |
Thanks to everyone helping with code, translations, bug reports, and testing. You don't need to write code to contribute.
Bug reports are the most valuable contribution right now: open an issue or choose Apple menu → About This Computer → Report a Bug… from the desktop.
Please include:
- Your Plasma version:
plasmashell --version - Your distro:
grep PRETTY_NAME /etc/os-release - The theme version:
cat VERSION - A screenshot or recording for visual issues
Pull requests are welcome. Keep them focused and test them with the ./vm harness before submitting. See CONTRIBUTING.md for the project workflow.
This is an independent reimplementation inspired by the macOS aesthetic. It is not affiliated with or endorsed by Apple or KDE. "macOS" and "Apple" are trademarks of Apple Inc.
The bundled wallpapers, system sounds, and SF Pro / SF Mono fonts remain Apple's property and are not covered by this project's license. All other code and theme assets are original or derived from compatibly licensed open-source work.
Licensed GPL-3.0.
Thanks to the open-source projects that inspired this one or fed assets into it. Everything here is maintained independently:
- EliverLara:
TahoeLauncher, the inspiration for the Launcher plasmoid. - vinceliuice:
MacTahoe-icon-themefor the icons, cursors, and GTK inspiration; and theMacTahoe-gtk-themeFirefox CSS/SVG, maintained here as an MIT-licensed fork and integrated with this project's profile backup and restore system. - taj-ny and 4v3ngR: Better Blur and its glass fork, the starting point of the Acrylic Glass effect (the KWin blur authors stay credited in the source headers).
- luisbocanegra:
plasma-panel-colorizerv7.3.0, bundled offline and installed by the layout step to tint the panels (GPL-3.0, license shipped alongside). - Matin Lotfaliei / KDE-Rounded-Corners: the GPL-3.0 KWin rounded-window effect, fetched from the pinned v0.9.0 release and built online against the host KWin SDK (license installed alongside).
- ful1e5:
apple_cursor, inspiration for an alternate macOS-style cursor. - sahibjotsaggu:
San-Francisco-Pro-Fonts, where the SF Pro / SF Mono bundle comes from. - Lucide: copy icons bundled in the global menu (ISC, © Lucide Contributors).
- 512pixels.net: high-resolution macOS wallpaper archive.
Please support their efforts too: star their repos, report bugs upstream, and contribute back when you can.
If a credit is missing, please open an issue.












