Skip to content

Installation

Glimpse is currently easiest to install on Arch-based systems from the AUR.

Install

sh
yay -S glimpse-desktop-bin

Use another AUR helper if you prefer one.

Enable The Desktop Pieces

For a normal Niri setup, enable the shell and lock screen:

sh
systemctl --user enable --now glimpse-shell.service
systemctl --user enable --now glimpse-lock.service

This starts the panel and the background services Glimpse uses for locking and idle behavior. Idle policy and night light run inside the shell service.

Check It Worked

You should see the Glimpse panel in your Niri session.

If it does not appear, check the shell service:

sh
systemctl --user status glimpse-shell.service

For logs:

sh
journalctl --user -u glimpse-shell.service -e

Customize It

Next, create your config file, choose what appears in the panel, and tune background services. Start with Configuration.

GoalPage
Set up panels and appletsConfiguration
Tune night light and idle rulesConfiguration
Change colors and CSSTheming
Configure wallpaperWallpaper
Configure lock screenLock
Add custom widgetsCustom Applets

Common First Fixes

ProblemTry this
Panel does not appearMake sure you are inside a Niri session, then check glimpse-shell.service.
Wallpaper does not showStop other wallpaper tools first.
Lock does nothingEnable glimpse-lock.service, then run loginctl lock-session.
Night light does not change colorCheck Night Light.
Idle rules do nothingCheck Idle.