iNiR  by snowarch

Niri compositor shell with dynamic theming and AI integration

Created 3 months ago
453 stars

Top 66.5% on SourcePulse

GitHubView on GitHub
Project Summary

A complete desktop shell for the Niri Wayland compositor, iNiR is a fork of illogical-impulse designed for users seeking deep system-wide visual consistency. It automatically adapts the shell, applications, and login screen to match the user's wallpaper, offering a highly integrated and aesthetically unified desktop experience with flexible layout options.

How It Works

Built on the Quickshell framework, iNiR employs dynamic color propagation (matugen) to synchronize the desktop environment with wallpaper colors. It features two distinct, switchable panel families: "Material ii" (floating, sidebar-centric) and "Waffle" (Windows 11-inspired taskbar). This approach provides a novel, adaptive theming system that extends beyond the shell to applications like GTK/Qt, terminals, Firefox, and Discord.

Quick Start & Requirements

  • Installation: Clone the repository and execute the ./setup script, which handles dependencies, configuration, and theming.
  • Prerequisites: The ./setup script is fully supported on Arch Linux. Manual installation instructions are available in docs/INSTALL.md for other distributions.
  • Links:
    • Installation & Setup: README, docs/INSTALL.md, docs/SETUP.md
    • Keybinds: docs/KEYBINDS.md
    • Community: Discord (mentioned, link not provided in text)

Highlighted Details

  • Dynamic Theming: Automatic color adaptation across the shell, GTK/Qt apps, terminals, Firefox, Discord, and SDDM login screen based on wallpaper.
  • Visual Styles: Five distinct styles: Material, Cards, Aurora (glass blur), iNiR (TUI-inspired), and Angel (neo-brutalism).
  • Switchable Panel Families: Seamlessly toggle between "Material ii" (floating bar, sidebars, dock) and "Waffle" (Windows 11 taskbar, action center).
  • Integrated Widgets & Sidebars: Includes app drawer, AI chat, media player, anime tracker, Reddit feed, translator, calendar, notifications, system monitor, clipboard manager, OCR tools, and more.
  • System Utilities: Features auto-updates with rollback, GameMode integration, Polkit agent, on-screen keyboard, and autostart manager.

Maintenance & Community

The project is a fork of end-4's illogical-impulse and utilizes the Quickshell framework. A Discord community is mentioned for support and discussion. Development appears active through its update and migration system.

Licensing & Compatibility

The specific open-source license is not explicitly stated in the provided README text. Compatibility for commercial use or linking with closed-source projects is also not detailed.

Limitations & Caveats

The ./setup installer is exclusively supported on Arch Linux; other distributions require manual installation. The project carries a "personal project" disclaimer ("It works on my machine. YMMV."), suggesting potential variability in user experience. The absence of explicit licensing information poses a risk for adoption decisions.

Health Check
Last Commit

19 hours ago

Responsiveness

Inactive

Pull Requests (30d)
18
Issues (30d)
10
Star History
227 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.