A GNOME Shell extension that adds a macOS-style magnification wave effect to dock icons when the mouse hovers over them.
The hovered icon grows by a configurable number of pixels and neighbouring icons scale down progressively, creating the familiar ripple effect from the macOS dock — all without touching the dock's CSS or layout.
If this extension helps you, consider buying me a coffee:
- Smooth wave magnification on hover
- Pixel-based zoom: the growth is always the same absolute pixel amount regardless of icon size
- Works with Ubuntu Dock, Dash to Dock, Dash to Panel, and the default GNOME dash
- Only uses transform scaling — no layout shifts, no CSS overrides
- Icons scale from their visual centre — no positional shift on hover
- Anti-distortion options: configurable scaling filter and offscreen redirect control
- Fully configurable via a preferences UI (no file editing needed)
- Theme-agnostic: compatible with any icon theme or GTK theme
- Tiny footprint with icon caching and change-detection to avoid redundant redraws
| GNOME Shell | Supported |
|---|---|
| 47 | ✓ |
| 48 | ✓ |
| 49 | ✓ |
git clone https://github.com/gilson-fonsaca/magnific_launcher
cd magnific_launcher
./install.shThe script:
- Copies all files to
~/.local/share/gnome-shell/extensions/magnific-launcher@gilsonf/ - Compiles the GSettings schema
- Enables the extension via
gnome-extensions enable
-
Clone or download this repository.
-
Copy the directory to the extensions folder:
cp -r magnific_launcher/ \ ~/.local/share/gnome-shell/extensions/magnific-launcher@gilsonf/The folder name must match the
uuidinmetadata.json:magnific-launcher@gilsonf -
Compile the GSettings schema:
glib-compile-schemas \ ~/.local/share/gnome-shell/extensions/magnific-launcher@gilsonf/schemas/ -
Reload GNOME Shell (see section below), then enable the extension:
gnome-extensions enable magnific-launcher@gilsonf
(Once published) Visit the extension page on extensions.gnome.org and toggle the switch.
./uninstall.sh# Enable
gnome-extensions enable magnific-launcher@gilsonf
# Disable
gnome-extensions disable magnific-launcher@gilsonfYou cannot reload the shell in-place on Wayland. The easiest approach is to log out and log back in, or use a nested shell:
# Launch a nested GNOME Shell for quick iteration (no log-out needed)
dbus-run-session -- gnome-shell --nested --waylandPress Alt + F2, type r, and press Enter.
gnome-extensions disable magnific-launcher@gilsonf
gnome-extensions enable magnific-launcher@gilsonfNote: On Wayland, GJS caches ES modules for the lifetime of the session. If changes to
extension.jsdon't take effect after disable/enable, log out and log back in to force a full module reload.
Open the preferences window:
gnome-extensions prefs magnific-launcher@gilsonfOr use the GNOME Extensions app and click the settings gear next to Magnific Launcher.
| Setting | Default | Range | Description |
|---|---|---|---|
| Zoom amount | 8 px |
2 – 64 px | Extra pixels added to the hovered icon's size. Scale is computed as (iconSize + zoomPixels) / iconSize, so the visual growth is always the same absolute pixel amount. |
| Neighbour step | 0.10 |
0.00 – 0.50 | Scale reduction applied per ring of icons around the hovered icon. 0.00 = all visible icons zoom equally (flat); 0.50 = only the immediate neighbours receive any zoom (narrow wave). |
| Sharp scaling | off | on / off | Use nearest-neighbour filter instead of bilinear. Produces crisp pixel edges but may look jagged at non-integer zoom levels. Recommended for flat/solid icon themes. |
How the wave is calculated (example: 48 px icons, zoom = 8 px, step = 0.10):
hoveredScale = (48 + 8) / 48 = 1.167
distance 1 = 1.167 − 0.10 = 1.07
distance 2 = 1.167 − 0.20 = 0.97 → clamped to 1.0 (no zoom)
| Setting | Default | Range | Description |
|---|---|---|---|
| Animation duration | 120 ms |
50 – 500 ms | Duration of the zoom-in / zoom-out ease animation. |
| Restore delay | 40 ms |
0 – 200 ms | Delay before icons return to normal size after the pointer leaves the dock. Prevents flickering on quick pointer passes. |
- Confirm the extension is enabled:
gnome-extensions list --enabled | grep magnific - Check the extension state:
gnome-extensions show magnific-launcher@gilsonf
- Check for errors in the GNOME Shell journal:
journalctl -f -o cat /usr/bin/gnome-shell
- If you use Ubuntu Dock, Dash to Dock, or Dash to Panel, make sure that extension is also enabled. A shell reload after enabling both usually resolves ordering issues.
Make sure hardware acceleration is working. On VMs or software renderers, Clutter animations may be choppy. Try lowering the Animation duration to 60 ms in the preferences.
- Keep Zoom amount between 6–16 px. Larger values amplify the blur inherent to upscaling pre-rendered icon textures.
- Enable Sharp scaling in the preferences for pixel-sharp edges (best with flat/solid icon themes).
- Both options are in Preferences → Magnification.
This should not happen with the current version — icons scale from their visual centre (pivot_point = 0.5, 0.5). If you observe a shift, it may be caused by padding inside the icon actor. Try a different dock or file a bug report.
The extension detects docks in priority order:
Ubuntu Dock → Dash to Dock → Dash to Panel → Default GNOME dash.
If you use an uncommon dock, open extension.js and add a detection branch in _findDashContainers().
GNOME Shell extension APIs can change between major versions. Check the shell-version array in metadata.json, add the new version number, and run ./install.sh again.
magnific_launcher/
├── metadata.json Extension manifest (uuid, shell-version, settings-schema)
├── extension.js Main extension logic (ES module, GNOME Shell 47+)
├── prefs.js Preferences UI (libadwaita, GNOME Shell 47+)
├── schemas/
│ └── org.gnome.shell.extensions.magnific-launcher.gschema.xml
├── install.sh Install & compile schema script
├── uninstall.sh Uninstall script
└── README.md This file
Copyright (C) 2026 Gilson Fonseca
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the LICENSE file for the full text.
