# Glimpse

> Glimpse is a polished desktop shell toolkit for Niri on Wayland: panel,
> idle policy, lock screen, wallpaper, built-in night light, and custom applets.
> Extension authors can add panel widgets via `command` applets or long-running
> `exec` applets that speak a line protocol.

The pages below are LLM-optimized, single-file references for generating or
editing Glimpse config and applet code.

## Configuration References

- [Configuration Reference](https://alex-oleshkevich.github.io/glimpse/llms/configuration): Main `config.toml` reference: discovery order, panels, theme mode, services, wallpaper, lock, calendar, and custom applet package placement.
- [Applet Configuration Reference](https://alex-oleshkevich.github.io/glimpse/llms/applets): Built-in applet config defaults, enums, placeholders, and commented optional examples.

## Extension References

- [Command Applet - Full Reference](https://alex-oleshkevich.github.io/glimpse/llms/command): Experimental TOML-only launcher buttons and right-click menus.
- [Exec Applet - Full Reference](https://alex-oleshkevich.github.io/glimpse/llms/exec): Experimental long-running applet processes driving panel status and popovers over a line protocol. Includes protocol, component types, events, and SDK starters for Python, TypeScript, Rust, and Go.

## Human Documentation

- [Glimpse Home](https://alex-oleshkevich.github.io/glimpse/): Overview, installation, configuration, theming.
- [Configuration](https://alex-oleshkevich.github.io/glimpse/configuration): Human-friendly panel, service, wallpaper, lock, and calendar config.
- [Applet Reference](https://alex-oleshkevich.github.io/glimpse/applets/): Built-in applet reference.
- [Custom Applets Overview](https://alex-oleshkevich.github.io/glimpse/custom-applets/): Choosing between `command` and `exec` applets.