Skip to content
NarkAgniPublic

About

A highly animated, deeply customizable dock extension for GNOME Shell with true magnification, advanced window effects, and a dynamic wallpaper-aware theme engine.

Topics

Resources

Stars

224 stars

Watchers

7 watching

Forks

Latest commit

 

History

65 Commits

Folders and files

Repository files navigation

Note to Contributors

If you want to contribute by improving this README to make it look better and more readable, you are most welcome to submit a PR!

(Honestly, I don't feel like updating it myself right now, so it would be awesome if someone from the community could help out!)



Dhruva Logo

Dhruva

A clean and customizable dock for GNOME Shell

GNOME Shell License Release Downloads

Install via EGO • Report Issue • Donate


Dhruva Dock Main Preview

Feature Highlights

Physics & Magnification Window Shaders
Magnification

Fluid Motion: Hermite smoothstep zoom curves, slot expansion & outward rise.

Window Minimize Effects

Custom Shaders: Magic Lamp (Genie), Vortex, Origami, CRT, and Jelly minimize.

Window Previews App Stacks & Folders
Aero Peek Previews

Aero Peek: Live thumbnails with instant on-screen window isolation.

App Stacks & Folders

Native Stacking: Group apps directly via Ctrl + Drag with emoji icons.

Click Engine Preferences Control
Click Animations

Hardware Feedback: 20+ responsive animations on item click.

Preferences UI

Granular Customization: Dial in geometries, spring physics, and color themes.


Architecture & Features

  • Motion Engine: Supports 6 magnification profiles (Coverflow, Jelly, Fluid, Domino, Cylinder, Magnetic) with dynamic slot push and custom axis elevation.
  • Window Shaders: Hardware-accelerated minimize routines including Magic Lamp, Vortex, Origami, CRT, and Jelly.
  • Display Adaptability: Omni-directional placement across all 4 screen edges, multi-monitor configuration, and edge-to-edge panel modes.
  • Window Management: Live Aero Peek previews, workspace isolation, and intelligent window dodge / auto-hide.
  • Productivity Modules: Integrated digital clock, shredding trash can, Quick Launch (Super + 1-9), and JSON profile import/export.

Changelog & Updated Features

  • vX.X.X (Latest): [Add your latest features or updates here, e.g., Added new window minimize shaders]
  • vX.X.X: [Add previous updates here, e.g., Improved aero peek previews and physics engine]
  • For a full list of changes and release notes, please check out the Releases Page.

Installation

Method 1: GNOME Extensions Website

Install the verified build directly from the official portal:

extensions.gnome.org/extension/9495/dhruva

Method 2: Manual Build

git clone https://github.com/narkagni/dhruva.git
cd dhruva
chmod +x manage.sh
./manage.sh install

Restart your GNOME session:

  • X11: Press Alt + F2, type r, and press Enter
  • Wayland: Log out and log back in

Enable the extension:

gnome-extensions enable dhruva@narkagni

Support Development

Dhruva is free and open-source software distributed under the GPL-3.0 license. If it improves your Linux workflow, consider supporting its maintenance:

Buy Me A Coffee

Cryptocurrency Addresses
Bitcoin (BTC) 1GSHkxfhYjk1Qe4AQSHg3aRN2jg2GQWAcV
Ethereum (ETH) 0xf43c3f83e53495ea06676c0d9d4fc87ce627ffa3
Tether (USDT - TRC20) THnqG9nchLgaf1LzGK3CqdmNpRxw59hs82

Maintained with precision by NarkAgni • Released under GPL-3.0 License

About

A highly animated, deeply customizable dock extension for GNOME Shell with true magnification, advanced window effects, and a dynamic wallpaper-aware theme engine.

Topics

Resources

Stars

224 stars

Watchers

7 watching

Forks

Releases

Packages

Contributors

Languages