Skip to content
<open-source>
Oeiuwq Faith Blog OpenSource Porfolio

snowarch/iNiR

A Niri shell illogical-impulse based - with some modifications..
Source code at GitHub https://snowarch.github.io/iNiR/
snowarch/iNiR.json
{
  "createdAt": "2025-11-23T03:28:04Z",
  "defaultBranch": "main",
  "description": "A Niri shell illogical-impulse based - with some modifications..",
  "fullName": "snowarch/iNiR",
  "homepage": "https://snowarch.github.io/iNiR/",
  "language": "QML",
  "name": "iNiR",
  "pushedAt": "2026-03-19T12:14:06Z",
  "stargazersCount": 626,
  "topics": [
    "dotfiles",
    "linux",
    "niri",
    "quickshell",
    "ricing"
  ],
  "updatedAt": "2026-03-19T21:26:56Z",
  "url": "https://github.com/snowarch/iNiR"
}

iNiR

🌐 Languages: English | Español | Русский

iNiR

A complete desktop shell built on Quickshell for the Niri compositor
Originally forked from end-4's illogical-impulse — evolved into its own thing

Install • Keybinds • IPC Reference • Discord

Screenshots

Section titled “Screenshots”
Material ii — floating bar, sidebars, Material Design aesthetic
Waffle — bottom taskbar, action center, Windows 11 vibes

Features

Section titled “Features”

Theming & Appearance

Section titled “Theming & Appearance”

Pick a wallpaper and everything adapts — the shell, GTK/Qt apps, terminals, Firefox, Discord, even the SDDM login screen. All automatic.

  • 5 visual styles — Material (solid), Cards, Aurora (glass blur), iNiR (TUI-inspired), Angel (neo-brutalism)
  • Dynamic wallpaper colors via matugen — propagate to the entire system
  • 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 make your own
  • Video wallpapers — mp4/webm/gif with optional blur, or frozen first-frame for performance
  • SDDM login theme — Material You colors synced with your wallpaper
  • Desktop widgets — clock (multiple styles), weather, media controls on the wallpaper layer

Two Panel Families

Section titled “Two Panel Families”

Switch between them on the fly with Super+Shift+W:

  • Material ii — floating bar (top/bottom, 4 corner styles), sidebars, dock (all 4 positions), control panel, vertical bar variant
  • Waffle — Windows 11-inspired bottom taskbar, start menu, action center, notification center, widget panel, task view

Sidebars & Widgets (Material ii)

Section titled “Sidebars & Widgets (Material ii)”

The left sidebar doubles as an app drawer:

  • AI Chat — Gemini, Mistral, OpenRouter, or local models via Ollama
  • YT Music — full player with search, queue, and playback controls
  • Wallhaven browser — search and apply wallpapers directly
  • Anime tracker — AniList integration with schedule view
  • Reddit feed — browse subreddits inline
  • Translator — powered by Gemini or translate-shell
  • Draggable widgets — crypto prices, media player, quick notes, status rings, week calendar

The right sidebar covers everyday essentials:

  • Calendar with event integration
  • Notifications center
  • Quick toggles — WiFi, Bluetooth, night light, DND, power profiles, WARP VPN, EasyEffects (Android or classic layout)
  • Volume mixer — per-app volume control
  • Bluetooth & WiFi device managers
  • Pomodoro timer, todo list, calculator, notepad
  • System monitor — CPU, RAM, temp

Tools

Section titled “Tools”
  • Workspace overview — adapted for Niri’s scrolling model, with app search and calculator
  • Window switcher — Alt+Tab across all workspaces
  • Clipboard manager — searchable history with image preview
  • Region tools — screenshots, screen recording, OCR text extraction, 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-like identification via SongRec
  • Voice search — record and search via Gemini

System

Section titled “System”
  • GUI settings — configure everything without touching config files
  • GameMode — auto-disables effects when fullscreen apps are detected
  • Auto-updates — ./setup update with rollback, migrations, and user-change preservation
  • Lock screen and session screen (logout/reboot/shutdown/suspend)
  • Polkit agent, on-screen keyboard, autostart manager
  • 15+ languages — auto-detected, with AI-assisted translation generation
  • Night light — scheduled or manual blue light filter
  • Weather — Open-Meteo, supports GPS, manual coords, or city name
  • Battery management — configurable thresholds, auto-suspend at critical
  • Shell update checker — notifies when new versions are available

Quick Start

Section titled “Quick Start”

Arch Linux:

Terminal window
git clone https://github.com/snowarch/inir.git
cd inir
./setup install       # Interactive — asks before each step
./setup install -y    # Automatic — installs everything without prompts

The installer handles dependencies, configs, theming — everything.

Other distros: The installer fully supports Arch only. Manual installation guide in [docs/INSTALL.md]!(docs/INSTALL.md).

Updating:

Terminal window
./setup update        # Check remote, pull, sync, restart shell

Or run ./setup with no arguments for the interactive TUI menu where you can update, migrate, rollback, diagnose, and more.

Your configs stay untouched. New features come as optional migrations. Rollback included if something breaks (./setup rollback).

Keybinds

Section titled “Keybinds”
KeyAction
Super+SpaceOverview — search apps, navigate workspaces
Alt+TabWindow switcher
Super+VClipboard history
Super+Shift+SScreenshot region
Super+Shift+XOCR region
Super+,Settings
Super+Shift+WSwitch panel family

Full list and customization guide: [docs/KEYBINDS.md]!(docs/KEYBINDS.md)

Documentation

Section titled “Documentation”
[INSTALL.md]!(docs/INSTALL.md)Installation guide
[SETUP.md]!(docs/SETUP.md)Setup commands — updates, migrations, rollback, uninstall
[KEYBINDS.md]!(docs/KEYBINDS.md)All keyboard shortcuts
[IPC.md]!(docs/IPC.md)IPC targets for scripting and custom keybinds
[PACKAGES.md]!(docs/PACKAGES.md)Every package and why it’s there
[LIMITATIONS.md]!(docs/LIMITATIONS.md)Known limitations and workarounds
[OPTIMIZATION.md]!(docs/OPTIMIZATION.md)QML performance guide for contributors

Troubleshooting

Section titled “Troubleshooting”
Terminal window
qs log -c ii                    # Check logs — the answer is usually here
qs kill -c ii && qs -c ii       # Restart the shell
./setup doctor                  # Auto-diagnose and fix common problems
./setup rollback                # Undo the last update

Check [LIMITATIONS.md]!(docs/LIMITATIONS.md) before opening an issue — it might already be documented.

Credits

Section titled “Credits”
  • end-4 — original illogical-impulse for Hyprland, where this all started
  • Quickshell — the framework powering this shell
  • Niri — the scrolling tiling Wayland compositor

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