srinivasr

srinivasr / nirimod

Public

NiriMod – A visual, interactive configuration interface for the niri Wayland compositor.

configurator gui niri niri-settings wayland
19
0
100% credibility
Found Apr 18, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

NiriMod provides a graphical interface for visually configuring the Niri Wayland compositor's monitors, key bindings, layouts, animations, and other settings.

How It Works

1
🔍 Discover NiriMod

You hear about a friendly app that lets you customize your desktop screens, shortcuts, and animations without touching any text files.

2
📥 Get it set up

Run a simple one-click installer that checks your computer and adds the app to your menu.

3
🚀 Open the app

Launch NiriMod from your applications menu and see a beautiful sidebar with all your desktop settings.

4
🎨 Tweak visually

Drag your screens into place on a canvas, light up your keyboard to see shortcuts, or curve smooth animations—just like playing with toys.

5
💾 Save safely

Hit save, and it checks everything before applying your changes with unlimited undo if needed.

✨ Enjoy your setup

Your desktop feels perfectly yours—smooth animations, handy shortcuts, and screens just right—with easy profiles to switch moods.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is nirimod?

NiriMod is a polished Python-built GTK4 interface for configuring the niri Wayland compositor, turning manual KDL file edits into a visual, interactive experience. Drag monitors on a canvas, tweak bindings via a live keyboard visualizer, and edit animations with a Bézier curve tool—all with instant previews. It validates changes before saving, supports unlimited undo/redo, and lets you switch profiles like "Gaming" or "Work" without risking your setup.

Why is it gaining traction?

Unlike text-only config tinkering, NiriMod offers collision detection for shortcuts, raw KDL editing fallback, and live niri IPC integration for real-time workspace/window data. The native libadwaita design feels at home on GNOME/Wayland desktops, and one-liner install via curl handles deps across distros. Inspired by Hyprland tools, it fills niri's GUI gap with safety nets that prevent broken configs.

Who should use this?

Niri users frustrated by verbose KDL syntax for outputs, bindings, or gestures. Tiling WM enthusiasts on Wayland wanting drag-and-drop monitor layouts or per-key binding overviews without CLI trial-and-error. Python/GTK devs prototyping compositor tweaks who value visual feedback over raw files.

Verdict

Grab it if you're on niri—install script is bulletproof, docs solid with demos. At 19 stars and 1.0% credibility, it's early but stable for daily use; fork-friendly for custom needs.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.