niri is a scrollable-tiling Wayland compositor. This is a curated list of resources related to niri.

Please read the contributing guidelines before contributing to this list.

Contents

• Help and Discussion
• Packages
• Tools
  • Toolkits
  • Window and Workspace Management
  • Session Management
  • Wallpapers and Visuals
  • System Integration and Automation
  • Miscellaneous
• Custom Shaders
• Bars and Widgets
• Custom Shells
• DE Integration
• Distro Integration
• Rices and OOTB Setups

Help and Discussion

• niri Wiki - The official wiki, containing installation instructions and usage guides.
• niri Matrix Channel - The official Matrix channel, where you can ask questions and get help from the community.
• niri Discord server - A community maintained Discord server.
• niri subreddit - A community driven subreddit.

Packages

• Community Packages - A list of community maintained packages for niri.
• niri Flake - A Nix flake with cached binary builds and batteries-included modules.
• niri-nix - A Nix flake with cached binary builds and freeform config.

Tools

Toolkits

For bundles of various utilities.

• niri-companion - A toolkit that adds extra functionality.
• niri-scripts - A collection of scripts. Notably allows setting wallpaper per workspace.
• niri tweaks - A collection of scripts. Notably includes a script which allows tiling N windows before scrolling new ones.
• Nirius - Utility commands.
• piri - A collection of plugins making use of niri IPC.

Window and Workspace Management

For utilities that assist in managing windows and workspaces.

• ndrop - Emulate tdrop.
• nfsm - Fullscreen manager.
• niri-empty - Execute a shell command when focusing an empty workspace.
• niri-float-sticky - A utility to make floating windows visible across all workspaces — similar to "sticky windows" in other compositors.
• niri-ror - Focuses an app if it's open, or starts a new instance if not. With advanced window matching and multi-instance cycling.
• niri-scratchpad - Scratchpad support.
• niri-scratchpad-rs - Dynamic scratchpads.
• niri-sidebar - Manage windows using a floating sidebar.
• niri-switch - A fast task switcher — similar to Alt-Tab known from Windows, Gnome, KDE Plasma etc¹.
• nirimap - A minimal workspace minimap overlay.
• nsticky - A utility to make windows visible across all workspaces.

Session Management

For saving, restoring, and managing user sessions.

• niri-session-manager - Automatically save and restore windows.
• nirinit - Session manager that automatically saves and restores your window layout.
• swaytreesave - CLI to save and load your compositors tree/layout.

Wallpapers and Visuals

For managing wallpapers and other visual elements.

• hyprlax - Smooth parallax wallpaper daemon.
• pandora - Parallax-scrolling wallpaper daemon for Wayland.
• wayvid - A dynamic video wallpaper engine for Wayland compositors.

System Integration and Automation

For tools that integrate niri with other system components or automate tasks.

• Anyrun - A Wayland native krunner-like runner, made with customizability in mind. Provides niri-focus plugin.
• IIO-Niri - Listen to iio-sensor-proxy and update niri output orientation depending on the accelerometer orientation.
• kunai - Automatically switch keyboard layouts based on which physical keyboard is being used.
• NASW - Automatically switch audio based on active windows.
• niri-autoselect-portal - Always autoselect the dynamic cast target without any prompts.
• nirilayout - Quickly switch output configuration between different layouts.
• Stasis - A modern Wayland idle manager with smart timeouts, media awareness, and app-specific inhibition.
• system76-scheduler-niri - A simple daemon to update the foreground process of system76-scheduler based on the focused window.
• vim-niri-nav - Seamless navigation between niri windows and (neo)vim splits with the same key bindings.

Miscellaneous

• arbtt-capture-wl - Time tracker utility arbtt ported to Wayland.
• niri-screen-time - A utility that collects information about how much time you spend in each application.
• niri-settings - Basic configuration GUI for niri config.

Custom Shaders

• Nirimation - A host for custom shaders to be used as animations.

Bars and Widgets

• ashell - A ready to go Wayland status bar.
• bar-rs - A simple status bar, written using iced-rs.
• eww-niri-workspaces - A Rust binary that outputs workspace information from niri-ipc to be consumed by eww.
• i3bar-river - A port of i3bar for Wayland compositors, to be used with something like i3status-rust.
• Ignis - A widget framework for building desktop shells, written and configurable in Python.
• Ironbar - A customisable Wayland GTK bar written in Rust.
• Niri Taskbar - Provides a Waybar taskbar module for niri.
• niri_window_buttons - A Waybar module for displaying and managing traditional window buttons.
• vibepanel - A GTK4 panel for Wayland with integrated notifications, OSD, and quick settings.
• Waybar - Highly customizable Wayland bar based on GTK.
• waybar-niri-windows - A module for Waybar that displays a focus indicator for the current workspace.

Custom Shells

• DankMaterialShell - Quickshell based shell featuring Material 3 design principles, with a heavy focus on functionality and customizability.
• Delta Shell - A desktop shell based on AGS with many features.
• desktop-shell - Custom AGS shell for Wayland compositors supporting wayland-layer-shell.
• Exo - A Material 3 inspired desktop shell created with Ignis.
• GPUi Shell - A GPUI based shell written in Rust.
• IgnisNiriShell - An Ignis based shell.
• iNiR - end-4's quickshell config modified to work with niri.
• Noctalia - A sleek and minimal desktop shell built with Quickshell.
• qml-niri - A QML plugin for interacting with niri via its IPC protocol.

DE Integration

• niri on Cosmic - A Cosmic extension that allows niri as a session option, allowing you to use niri with the Cosmic desktop environment.
• niri on LXQt - LXQt is a lightweight Qt-based desktop environment that allows setting niri as compositor, while its modules can also be used standalone in niri-session.

Distro Integration

• CachyOS - An Arch Linux based distribution focused around gaming, performance, and being user-friendly. It provides niri as an install option via its installer.
• KaOS - An independent, built from-scratch Linux distribution, focused on Qt. niri and Noctalia are shipped as the default desktop environment.
• Pika OS - PikaOS is a Debian sid based Linux distribution focused on gaming and performance optimization, which provides a niri edition ISO.

Rices and OOTB Setups

• Setup Showcase - A showcase of niri setups, where users can share their configurations and get inspiration from others.
• OOTB setups - A collection of out-of-the-box niri configurations that can be easily installed to get a fully functional setup quickly.

Footnotes

1. As of release 25.11, niri has a built-in window switcher. ↩