Home

iNiR

A complete desktop shell for Niri, built with Quickshell and QML.

It provides the bar, dock, sidebars, notifications, settings, wallpapers, overview, lock screen, IPC and theming in one shell. Niri is the supported compositor. Hyprland support is secondary.

Start here

• Install
• Setup, updates and rollback
• Keybinds
• IPC reference
• Panel families
• Configuration
• Known limitations

Common commands

inir run
inir restart
inir settings
inir logs
inir doctor
inir update

Branches

main is the stable branch used by installations and updates.

prerelease is where development happens. It may be ahead by a lot. That is the point.

Runtime shape

Niri
  -> Quickshell
  -> shell.qml
  -> shared config and services
  -> ii or Waffle
  -> panels, overlays and widgets

The shell is configurable through Settings and config.json. Persistent writes go through the config service; editing QML is not part of normal use.

Reference

Area	Page
Installation and packages	Install, Packages
Runtime and architecture	Runtime, Architecture
Services and modules	Services, Modules
Wallpapers and theming	Wallpaper, Theming
Compositor support	Compositors
Performance	Optimization

If the wiki disagrees with the current shell, the shell wins. Then the wiki gets fixed.