Gnoblin

Gnoblin is a standalone Wayland compositor session built on Mutter. Its Lua configuration and runtime API control compositor state; independent shell projects such as Bingux provide the panels, launchers, and other desktop UI. Build your own shell or try Bingux, a separate project that uses Gnoblin.

Bingux is one separate shell project that uses Gnoblin. Its packaged rules round the Files window, fill its CSD corner gaps and draw the window shadow.

Waybar provides the top bar; Quickshell provides the dock.

The configuration API links each setting to a detailed reference.

Get started

• Install Gnoblin
• Choose a shell
• Build a desktop

Configure

• Configuration API
• Configuration recipes
• Configuration guides

Develop

• Shell integration
• Compositor bridge
• Wayland protocols

Help

• Troubleshooting