A complete desktop shell for Niri, built on Quickshell
Install • Keybinds • IPC Reference • Discord • Contributing
English · Español · Русский · 中文 · 日本語 · Português · Français · Deutsch · 한국어 · हिन्दी · العربية · Italiano
Material ii — floating bar, sidebars, Material Design aesthetic
 |
 |
 |
|
 |
 |
Waffle — bottom taskbar, action center, Windows 11 vibes
 |
 |
Two panel families, switchable on the fly with Super+Shift+W:
- Material ii — floating bar, sidebars, dock, 5 visual styles (material, cards, aurora, inir, angel)
- Waffle — Windows 11-inspired taskbar, start menu, action center, notification center
Automatic theming — pick a wallpaper and everything adapts:
- Shell colors via Material You, propagated to GTK3/4, Qt, terminals, Firefox, Discord, SDDM
- 10 terminal tools auto-themed (foot, kitty, alacritty, starship, fuzzel, btop, lazygit, yazi)
- Theme presets: Gruvbox, Catppuccin, Rosé Pine, and custom
Compositor — built for Niri.
Full feature list
Pick a wallpaper and the entire system follows — shell, GTK/Qt apps, terminals, Firefox, Discord, SDDM login screen. All automatic.
- 5 visual styles — Material (solid), Cards, Aurora (glass blur), iNiR (TUI-inspired), Angel (neo-brutalism)
- Dynamic wallpaper colors via Material You — propagated system-wide
- 10 terminal tools auto-themed — foot, kitty, alacritty, starship, fuzzel, pywalfox, btop, lazygit, yazi
- App theming — GTK3/4, Qt (via plasma-integration + darkly), Firefox (MaterialFox), Discord/Vesktop (System24)
- Theme presets — Gruvbox, Catppuccin, Rosé Pine, and more — or create your own
- Video wallpapers — mp4/webm/gif with optional blur, or frozen first frame for performance
- SDDM login theme — Material You colors synced to your wallpaper
- Desktop widgets — clock (multiple styles), weather, media controls on the wallpaper layer
Left sidebar (app drawer):
- AI Chat — Gemini, Mistral, OpenRouter, or local models via Ollama
- YT Music — full player with search, queue, and controls
- Wallhaven browser — search and apply wallpapers directly
- Anime tracker — AniList integration with schedule view
- Reddit feed — browse subreddits inline
- Translator — via Gemini or translate-shell
- Draggable widgets — crypto, media player, quick notes, status rings, weekly calendar
Right sidebar:
- Calendar with event integration
- Notification center
- Quick toggles — WiFi, Bluetooth, night light, DND, power profiles, WARP VPN, EasyEffects
- Volume mixer — per-app control
- Bluetooth & WiFi device management
- Pomodoro timer, todo list, calculator, notepad
- System monitor — CPU, RAM, temperature
- Workspace overview — adapted for Niri's scrolling model, with app search and calculator
- Window switcher — Alt+Tab across all workspaces
- Clipboard manager — history with search and image preview
- Region tools — screenshots, screen recording, OCR, reverse image search
- Cheatsheet — keybind viewer pulled from your Niri config
- Media controls — full MPRIS player with multiple layout presets
- On-screen display — volume, brightness, and media OSD
- Song recognition — Shazam-style identification via SongRec
- Voice search — record and search via Gemini
- GUI settings — configure everything without touching files
- GameMode — auto-disables effects for fullscreen apps
- Auto-updates —
inir updatewith rollback, migrations, and user change preservation - Lock screen and session screen (logout/reboot/shutdown/suspend)
- Polkit agent, on-screen keyboard, autostart manager
- 9 languages — auto-detection, with AI-assisted translation generation
- Night light — scheduled or manual
- Weather — Open-Meteo, supports GPS, manual coordinates, or city name
- Battery management — configurable thresholds, auto-suspend on critical
- Shell update checker — notifies when new versions are available
git clone https://github.com/snowarch/inir.git
cd inir
./setup install # interactive — asks before each step
./setup install -y # automatic — no questions askedThe installer handles dependencies, system config, theming — everything. After install, run inir run to start the shell, or log out and back in.
inir run # launch the shell
inir settings # open settings GUI
inir logs # check runtime logs
inir doctor # auto-diagnose and fix
inir update # pull + migrate + restartSupported distros: Arch (automated installer). Other distros can install manually — see PACKAGES.md.
| Method | Command |
|---|---|
| System install | sudo make install && inir run |
| TUI menu | ./setup |
| Rollback | ./setup rollback |
| Key | Action |
|---|---|
Super+Space |
Overview — search apps, navigate workspaces |
Alt+Tab |
Window switcher |
Super+V |
Clipboard history |
Super+Shift+S |
Screenshot region |
Super+Shift+X |
OCR region |
Super+, |
Settings |
Super+Shift+W |
Switch panel family |
Full list: docs/KEYBINDS.md
15 wallpapers ship bundled. For more, check iNiR-Walls — a curated collection that works well with the Material You pipeline.
| INSTALL.md | Installation guide |
| SETUP.md | Setup commands — updates, migrations, rollback |
| KEYBINDS.md | All keyboard shortcuts |
| IPC.md | IPC targets for scripting and keybinds |
| PACKAGES.md | Every dependency and why it's there |
| LIMITATIONS.md | Known limitations and workarounds |
| ARCHITECTURE.md | Technical architecture overview |
inir logs # check recent runtime logs
inir restart # restart the active runtime
inir repair # doctor + restart + filtered log check
./setup doctor # auto-diagnose and fix common problems
./setup rollback # undo the last updateCheck LIMITATIONS.md before opening an issue.
See CONTRIBUTING.md for development setup, code patterns, and pull request guidelines.
- end-4 — original illogical-impulse for Hyprland
- Quickshell — the framework powering this shell
- Niri — the scrolling tiling Wayland compositor