Learn how to transform GNOME into a macOS-styled desktop with Blur my Shell, macOS theme, and custom dock. Step-by-step guide for Linux users.
Turn Your GNOME Desktop into a macOS-Style Experience
Published by Brav
Table of Contents
TL;DR
- Update your Arch or Arch-based distro with sudo pacman -Syu¹.
- Install GNOME Tweaks and Extension Manager via pacman or Flatpak².
- Add Blur my Shell extension and run the terminal command for GNOME 47³.
- Clone Vince Lewis’s macOS theme repo and run install.sh -t all -b bler -l libadwriter⁴.
- Configure Dash to Dock Animated: enable opening animation, set padding, radius, and edge distance⁵.
- Install the macOS icon set and point GNOME Tweaks to it⁶.
- Set Control+Space as a Spotlight-style search shortcut using the Quick Settings Tweaker⁷.
- Enable Caffeine to keep the screen bright during work⁸.
- Optional: add Impatience, Logo Menu, Privacy Quick Settings to fine-tune the look⁹.
Why this matters
You’ve probably spent hours customizing your GNOME shell, only to hit a wall when trying to emulate the clean, macOS-like experience. Extensions that work on GNOME 45 or 46 stop functioning on 47, dock padding and border radius are hard to tweak, and the macOS icon set is scattered across multiple repos. This guide unpacks each pain point, gives you a concrete workflow, and turns your desktop into a polished macOS clone in under an hour.
Core concepts
| Tool | Use Case | Limitation |
|---|---|---|
| GNOME Tweaks | Tweaks GNOME settings via GUI | Limited to built-in settings only |
| Extension Manager | Manage extensions from GNOME extensions site | Requires GNOME extensions API |
| Flatpak | Install extensions as Flatpak packages | Some extensions not packaged |
GNOME Tweaks
GNOME Tweaks is the Swiss-army knife for per-user adjustments—font smoothing, window snapping, panel options, and more. It also lets you enable Caffeine and Dash to Dock features that aren’t exposed in the default shell.
Extension Manager
The official manager pulls extensions from the GNOME extensions website and installs them into your user profile. It’s the safest way to keep extensions up to date.
Flatpak
When pacman stalls on a missing package, Flatpak offers a containerised alternative. Many GNOME extensions ship as Flatpak bundles, ensuring they run even on minimal base installs.
Step-by-step
1. Update the system
sudo pacman -Syu
This pulls the latest kernel, graphics stack, and GNOME shell updates, ensuring you’re on a compatible 47 kernel.¹
2. Install GNOME Tweaks and Extension Manager
sudo pacman -S gnome-tweaks extension-manager
If pacman cannot find them, try Flatpak:
flatpak install flathub org.gnome.Tweaks
flatpak install flathub com.github.wwmm.easytweaks
²
3. Add Blur my Shell
Navigate to https://extensions.gnome.org/extension/1069/blur-my-shell/ and click “On” in the browser. The extension will prompt you to install the GNOME Extension Manager if missing. The extension turns the opaque shell into a translucent blur, mimicking macOS’s “focus” panels.⁶
4. Enable Blur my Shell for GNOME 47
In GNOME 47, the extension does not activate automatically. Open a terminal and run:
gsettings set org.gnome.shell.extensions.blurmyShell enabled true
The command forces the shell to load the blur layer at startup.³
5. Configure Blur my Shell
Open GNOME Tweaks → Extensions → Blur my Shell. Set:
- Panel – On
- Overview – Off
- Application – On
- Opacity – 255
- Brightness – 1.000
- Sigma – 44
These values provide the sharpest, most macOS-like blur without compromising performance.⁴
6. Clone the macOS theme repo
git clone https://github.com/vince-lewis/macos-theme.git
cd macos-theme
The repo contains a Bash script that applies all theme components in one go.
7. Run the installer
./install.sh -t all -b bler -l libadwriter
The -t all flag tells the script to install GTK, icon, shell, and cursor themes. The -b bler option sets the background color to black and disables background blur. The -l libadwriter flag installs the “LibreOffice” color palette for full consistency.⁵
For Firefox, run:
./install.sh -f firefox
This patches the browser’s CSS to match the macOS palette.
8. Configure the dock (Dash to Dock Animated)
Open GNOME Tweaks → Extensions → Dash to Dock.
- Enable Opening animation.
- Set Dock padding to a high value (e.g., 30).
- Increase Border radius (e.g., 10).
- Raise Edge distance to create breathing room below the dock (e.g., 0).
- Set Border technology to 1 pixel.
These adjustments make the dock feel like macOS’s Dock: rounded corners, subtle shadows, and a gentle slide-in animation.⁶
9. Install macOS icons
Clone the icon set:
git clone https://github.com/vince-lewis/macos-icons.git
cd macos-icons
Run the provided installer:
./install.sh
This copies the icon set into ~/.local/share/icons and updates the icon theme database. Then, in GNOME Tweaks → Appearance → Icons, select macOS Icons.
The icons now match the official macOS palette, from Finder to system apps.
10. Spotlight-style search
GNOME doesn’t ship a Spotlight overlay, but the Quick Settings Tweaker adds a “Show search in overview” toggle. In Settings → Keyboard → Shortcuts → Search, set Control+Space to launch the overview. The overlay will appear as a centered, translucent search box, just like macOS.⁷
11. Fine-tune dark mode and background
- In GNOME Tweaks → Appearance → Themes, select macOS (Dark).
- Toggle Dark mode on in Settings → Appearance to switch between light and dark easily.
- In the Dock settings, set Background color to Black.
These small tweaks make the environment feel truly macOS-like.
12. Optional extensions
| Extension | Why it matters | How to install |
|---|---|---|
| Impatience | Removes the 0.5 s startup lag in GNOME 47 | Install via Extension Manager |
| Logo Menu | Places the Apple-style icon at the top of the panel | Extension Manager |
| Caffeine | Keeps the screen from dimming when you’re working | Extension Manager |
| Privacy Quick Settings | Adds quick toggles for VPN, firewall, etc. | Extension Manager |
| Quick Settings Tweaker | Clean up the top-right menu for a minimal look | Extension Manager |
If you find any extension slows the shell, uninstall it with:
gnome-extensions uninstall <uuid>
Replace
13. Uninstalling extensions
When you need to roll back a change, open GNOME Tweaks → Extensions and toggle the extension off. For a complete removal, use the command from the previous step. Don’t forget to clean the extension folder (~/.local/share/gnome-shell/extensions/) if a residual folder remains.
Conclusion
You’re now ready to work on a GNOME desktop that looks and behaves like macOS, complete with a translucent dock, a spotlight search, dark mode, and a polished icon set. The workflow is deterministic, reproducible, and requires only a handful of commands. If you’re stuck, revisit the FAQs or the step list for common pitfalls.
Note: The macOS theme repository and icon set are maintained by Vince Lewis. If you notice a bug or want to contribute, open an issue on the GitHub repo.
FAQ
What does “47” refer to in the context of GNOME? It’s the GNOME shell version number—currently GNOME 47 is the latest major release.
How do I enable Blur my Shell on GNOME 47? Run gsettings set org.gnome.shell.extensions.blurmyShell enabled true in a terminal.
Where can I find the macOS theme repository by Vince Lewis? The repo is on GitHub: https://github.com/vince-lewis/macos-theme.
What is the correct command to run install.sh for the theme? ./install.sh -t all -b bler -l libadwriter – this installs all theme components.
How can I set Control+Space as a Spotlight search? In Settings → Keyboard → Shortcuts → Search, assign Control+Space to launch the overview. The Quick Settings Tweaker will then display the Spotlight-style overlay.
Why is the background blur turned off? macOS themes prefer a solid background for the dock to keep the interface crisp; the script disables it for consistency.
Which extensions are optional for macOS look? Impatience, Logo Menu, Caffeine, Privacy Quick Settings, and Quick Settings Tweaker are optional but enhance the macOS feel.
Cited sources
- GNOME Tweaks
- Extension Manager
- Blur my Shell
- Dash to Dock Animated
- Vince Lewis macOS theme
- Caffeine
- Quick Settings Tweaker
- Privacy Quick Settings
- Logo Menu
- Flatpak
