README.md

February 25, 2026 ยท View on GitHub

GNOME Rounded Blur

A standalone library providing Blur.BlurEffect with corner radius support for GNOME Shell extensions. Basically it's just copy of ShellBlurEffect with corner mask and different gir namespace (Blur).

Build & install

From source

cd gnome-rounded-blur
meson setup build
meson compile -C build
sudo meson install -C build

Arch

yay -S gnome-rounded-blur

Usage in GNOME Shell Extensions

After installation, you can use the library in your extension:

import GObject from 'gi://GObject';
import Blur from 'gi://Blur';

const MyBlurEffect = GObject.registerClass({
    GTypeName: "MyBlurEffect"
}, class MyBlurEffect extends Blur.BlurEffect {
    constructor(params) {
        super({
            mode: Blur.BlurMode.BACKGROUND,
            radius: 30,
            brightness: 0.6,
            corner_radius: 14,  // From here you can set corner radius for blur
            ...params
        });
    }
});