Skip to content

About

Pulsar Liquid Glass — the liquid glass GNOME Shell extension as shipped in Pulsar OS, with a dedicated dock glass profile. Redistribution of ryohsuke1231/liquid-glass (MIT).

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

Pulsar Liquid Glass

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.

Provenance and licence

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.

The Pulsar desktop suite

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.

What Pulsar OS changes

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/ vs dist/: src/ is the TypeScript source and dist/ is the compiled JavaScript that GNOME Shell actually loads. They are in sync: rebuilding with npm run build reproduces every Pulsar change, including the dock glass profile.

Two modules are the exception. dist/dialogManager.js and dist/notificationCenterGlass.js are hand-written JavaScript with no TypeScript source, and extension.js imports them directly. npm run pack therefore does not clean dist/ first: wiping it would delete those two files and GNOME Shell would then fail to load the extension. If you remove dist/ by hand, restore those two files from git before rebuilding.

Installation

git clone https://github.com/Agnell02010/Pulsar-Liquid-Glass.git
cd Pulsar-Liquid-Glass
./install.sh

install.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.com

On Wayland, log out and back in after installing or replacing the extension.

Rebuilding from source

npm install
npm run build      # tsc -> dist/
npm run pack       # builds and produces the extension bundle

Do not run rm -rf dist yourself: dist/dialogManager.js and dist/notificationCenterGlass.js have no TypeScript source and would be lost, leaving extension.js with an import that no longer resolves. See the note above.

Settings

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).

About

Pulsar Liquid Glass — the liquid glass GNOME Shell extension as shipped in Pulsar OS, with a dedicated dock glass profile. Redistribution of ryohsuke1231/liquid-glass (MIT).

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages