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://github.com/snowarch/iNiR/wiki
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://github.com/snowarch/iNiR/wiki",
  "language": "QML",
  "name": "iNiR",
  "pushedAt": "2026-06-11T10:39:28Z",
  "stargazersCount": 1150,
  "topics": [
    "dotfiles",
    "linux",
    "niri",
    "quickshell",
    "ricing"
  ],
  "updatedAt": "2026-06-18T19:21:08Z",
  "url": "https://github.com/snowarch/iNiR"
}

iNiR

iNiR

A complete desktop shell for Niri, built on Quickshell

Version Stars Discord

Install • Keybinds • IPC Reference • Discord • Contributing

English · Español · Русский · 中文 · 日本語 · Português · Français · Deutsch · 한국어 · हिन्दी · العربية · Italiano

🤔 New here? Click if you have no idea what any of this is

What is this?

Section titled “What is this?”

iNiR is your entire desktop. The bar at the top, the dock, notifications, settings, wallpapers, all of it. Not a theme, not dotfiles you paste. A full shell that runs on Linux.

What do I need to run it?

Section titled “What do I need to run it?”

A compositor. That’s the thing that handles your windows and puts pixels on screen. iNiR is made for Niri (a tiling Wayland compositor). There’s some old Hyprland code from when this was a fork of end-4’s dots, but Niri is what I actually use and test.

The shell runs on Quickshell, a framework for building shells in QML (Qt’s UI language). You don’t need to know any of that to use it though, everything is configurable through the GUI or a JSON file.

How it all connects

Section titled “How it all connects”
your apps
   ↓
iNiR (shell: bar, sidebars, dock, notifications, settings...)
   ↓
Quickshell (runs QML shells)
   ↓
Niri (compositor: windows, rendering)
   ↓
Wayland → GPU

Is it stable?

Section titled “Is it stable?”

It’s a personal project that got out of hand. I use it daily, lots of people in the Discord do too. But stuff breaks sometimes, code is messy in places, I’m learning as I go.

If something doesn’t work, inir doctor fixes most things. Discord is active if that doesn’t help. Just don’t expect polished software, this is one person’s rice that others happen to like.

Why does it exist?

Section titled “Why does it exist?”

I wanted my desktop to look and work a certain way and nothing else did exactly that. Started as end-4’s Hyprland dots, became a full rewrite for Niri with way more features.

Words you’ll see around

Section titled “Words you’ll see around”
  • Shell: the UI layer (bar, panels, overlays)
  • Compositor: manages windows, draws to screen (Niri, Hyprland, Sway…)
  • Wayland: Linux display protocol (the new one, replaces X11)
  • QML: Qt’s declarative UI language, what iNiR is written in
  • Material You: Google’s color system that makes palettes from images (that’s the auto-theming)
  • ii / waffle: the two panel styles. ii = Material Design vibes, waffle = Windows 11 vibes. Super+Shift+W switches between them

Screenshots

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

[!WARNING] Not for low-spec machines. Everything is customizable though - disable features, strip panels, flatten the design. Read the docs, tweak config.json or Settings, you’ll figure it out.

Features

Section titled “Features”

New in 2.26

Section titled “New in 2.26”
  • Modular bar layout with a drag editor in Settings
  • Screen Time widget, local-only and opt-in
  • World Clock sidebar widget with timezone management
  • Smoother media title scrolling in the bar
  • Wallpaper shuffle controls in Settings
  • Better dock/taskbar app icon matching

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

Theming & Appearance

Section titled “Theming & Appearance”

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

Sidebars & Widgets (Material ii)

Section titled “Sidebars & Widgets (Material ii)”

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

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 — 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

System

Section titled “System”
  • GUI settings — configure everything without touching files
  • GameMode — auto-disables effects for fullscreen apps
  • Auto-updates — inir update with 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

Quick Start

Section titled “Quick Start”
Terminal window
git clone https://github.com/snowarch/inir.git
cd inir
./setup install       # interactive — asks before each step
./setup install -y    # automatic — no questions asked

The installer handles dependencies, system config, theming — everything. After install, run inir run to start the shell, or log out and back in.

Terminal window
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 + restart

Supported distros: Arch (automated installer). Other distros can install manually — see [PACKAGES.md]!(docs/PACKAGES.md).

MethodCommand
System installsudo make install && inir run
TUI menu./setup
Rollback./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: [docs/KEYBINDS.md]!(docs/KEYBINDS.md)

Wallpapers

Section titled “Wallpapers”

15 wallpapers ship bundled. For more, check iNiR-Walls — a curated collection that works well with the Material You pipeline.

Documentation

Section titled “Documentation”
[INSTALL.md]!(docs/INSTALL.md)Installation guide
[SETUP.md]!(docs/SETUP.md)Setup commands — updates, migrations, rollback
[KEYBINDS.md]!(docs/KEYBINDS.md)All keyboard shortcuts
[IPC.md]!(docs/IPC.md)IPC targets for scripting and keybinds
[PACKAGES.md]!(docs/PACKAGES.md)Every dependency and why it’s there
[LIMITATIONS.md]!(docs/LIMITATIONS.md)Known limitations and workarounds
[ARCHITECTURE.md]!(ARCHITECTURE.md)Technical architecture overview

Troubleshooting

Section titled “Troubleshooting”
Terminal window
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 update

Check [LIMITATIONS.md]!(docs/LIMITATIONS.md) before opening an issue.

Contributing

Section titled “Contributing”

See [CONTRIBUTING.md]!(CONTRIBUTING.md) for development setup, code patterns, and pull request guidelines.

Credits

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

Contributors • Changelog • MIT License