iNiR

A feature-rich Quickshell configuration for the Niri compositor
_{Fork of end-4's illogical-impulse, reimagined for Niri}

Installation • Keybinds • IPC Reference • Discord

---

Features

• Two panel families — Material Design or Windows 11 style, switchable on the fly
• Three visual styles — Material (solid), Aurora (glass blur), Inir (TUI-inspired)
• Workspace overview — Adapted for Niri's scrolling workspace model
• Window switcher — Alt+Tab that works across all workspaces
• Region tools — Screenshots, screen recording, OCR, reverse image search
• Clipboard manager — Searchable history with image preview
• Dynamic theming — Matugen extracts colors from your wallpaper
• Theme presets — Gruvbox, Catppuccin, and more, or build your own
• GameMode — Auto-disables effects when fullscreen apps are detected
• GUI Settings — Configure everything without touching JSON

---

Screenshots

Material ii — Floating bar, sidebars, Material Design aesthetic

Waffle — Bottom taskbar, action center, Windows 11 vibes

---

Quick Start

Arch Linux:

git clone https://github.com/snowarch/inir.git
cd inir
./setup install

Other distros: See docs/INSTALL.md for manual installation.

Updating:

./setup update

Your configs stay untouched. New features are offered as optional migrations.

---

Default Keybinds

Key	Action
Super+Space	Overview (search + workspace navigation)
Alt+Tab	Window switcher
Super+V	Clipboard history
Super+Shift+S	Region screenshot
Super+Shift+X	Region OCR
Super+,	Settings
Super+Shift+W	Cycle panel families

Full list: docs/KEYBINDS.md

---

Documentation

Document	Description
INSTALL.md	Installation guide
SETUP.md	Setup script, updates, rollback
KEYBINDS.md	Keyboard shortcuts
IPC.md	IPC targets for custom bindings
PACKAGES.md	Required packages
LIMITATIONS.md	Known limitations

---

Troubleshooting

qs log -c ii                    # Check logs
qs kill -c ii && qs -c ii       # Restart shell
./setup doctor                  # Auto-fix common issues
./setup rollback                # Undo last update

---

Credits

• end-4 — Original illogical-impulse for Hyprland
• Quickshell — The framework powering this shell
• Niri — The scrolling tiling Wayland compositor

---

_{This is a personal project. It works on my machine. YMMV.}