The Liquid Glass GNOME Shell extension as shipped in Pulsar OS: the translucent, refractive "liquid glass" effect (blur, tint, specular highlights, edge lighting) applied to the top bar and its menus, Quick Settings, notifications, OSDs, the dock and selected application windows.
This is a redistribution of
ryohsuke1231/liquid-glass by
Ryosuke Watanabe, licensed under the MIT License — see LICENSE.
The original project is the work of its author; Pulsar OS builds on it and
thanks them for releasing it.
The UUID is deliberately left unchanged (liquid-glass@thinkingcoding1231.gmail.com)
so that this build stays compatible with the upstream extension and with
users' existing settings.
- Liquid Glass — this repository: the glass shared by every panel.
- Pulsar CC 27 — the macOS-style Control Center.
- Pulsar Notification Center — the notifications and widgets drawer.
On a machine that still has the Control Centre shipped with the ISO
(macos-control-centre@pulsar.local), disable it: it carries an older
Notification Center of its own and would open a second, outdated drawer.
The only Pulsar-specific code is the dock glass profile: the dock is a wide,
short surface, so applying the shared glass profile to it makes the edge lens
collapse into a thin rim. The dock therefore gets its own profile, read from the
dock-glass-* keys of the schema:
| Purpose | Key | Uniform in the shader |
|---|---|---|
| Enable the effect on the dock | enable-dock-glass |
— |
| Edge profile exponent (dock override) | dock-glass-shape-n |
profile_shape_n |
| Peak refraction height (dock override) | dock-glass-max-z |
max_z |
| Displacement scale (dock override) | dock-glass-displacement |
displacement_scale |
| IOR (dock override) | dock-glass-ior |
— |
| Corner radius, tint, expand | dock-corner-radius, dock-tint-color, dock-glass-expand |
— |
A value of 0 means "inherit the shared profile". The implementation lives in
src/dockManager.ts (_applyDockGlassProfile, _bindDockGlassProfile,
_applyMagnifyOverflow) and compiles to dist/dockManager.js.
Note on
src/vsdist/:src/is the TypeScript source anddist/is the compiled JavaScript that GNOME Shell actually loads. They are in sync: rebuilding withnpm run buildreproduces every Pulsar change, including the dock glass profile.Two modules are the exception.
dist/dialogManager.jsanddist/notificationCenterGlass.jsare hand-written JavaScript with no TypeScript source, andextension.jsimports them directly.npm run packtherefore does not cleandist/first: wiping it would delete those two files and GNOME Shell would then fail to load the extension. If you removedist/by hand, restore those two files from git before rebuilding.
git clone https://github.com/Agnell02010/Pulsar-Liquid-Glass.git
cd Pulsar-Liquid-Glass
./install.shinstall.sh copies the extension into
~/.local/share/gnome-shell/extensions/liquid-glass@thinkingcoding1231.gmail.com,
compiles the GSettings schema and enables it. It reads the UUID from
metadata.json, so it is safe to re-run and does not depend on the folder's
name.
Manual install, if you prefer:
mkdir -p ~/.local/share/gnome-shell/extensions/liquid-glass@thinkingcoding1231.gmail.com
cp -r . ~/.local/share/gnome-shell/extensions/liquid-glass@thinkingcoding1231.gmail.com/
gnome-extensions enable liquid-glass@thinkingcoding1231.gmail.comOn Wayland, log out and back in after installing or replacing the extension.
npm install
npm run build # tsc -> dist/
npm run pack # builds and produces the extension bundleDo not run
rm -rf distyourself:dist/dialogManager.jsanddist/notificationCenterGlass.jshave no TypeScript source and would be lost, leavingextension.jswith an import that no longer resolves. See the note above.
The schema ships the Pulsar OS preset as its defaults: the dock glass profile, the menu/panel/notification/OSD/quick-settings glass, the optics (ior, rims, sheen, ambient occlusion, shadows), the spring values of the menu animations, the desktop clock and the launcher all match a stock Pulsar OS install out of the box. A fresh clone therefore looks like the screenshots with no manual tuning.
Three keys are deliberately left at their neutral defaults because they are
per-machine state rather than preferences: detected-extra-menus,
desktop-item-positions and preferences-advanced.
If you already had the extension installed before this preset landed, your dconf values win over the defaults. To adopt the new defaults, back up your settings first:
dconf dump /org/gnome/shell/extensions/liquid-glass/ > liquid-glass-backup.ini
dconf reset -f /org/gnome/shell/extensions/liquid-glass/dconf reset discards personal tweaks, so keep the dump if you want them
back (dconf load /org/gnome/shell/extensions/liquid-glass/ < liquid-glass-backup.ini).