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
• Scripts
• Bars and Widgets
• Custom Shells
• DE Integration
• Distro Integration
• Rices

Help and Discussion

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

Packages

• Community Packages - A list of community maintained packages for niri.
• niri Flake - A Nix flake for niri, providing a convenient way to install and manage niri on NixOS.

Tools

• Anyrun - A Wayland native krunner-like runner, made with customizability in mind. Provides niri-focus plugin.
• Chameleos - Wayland screen annotation tool.
• hyprlax - Smooth parallax wallpaper daemon.
• IIO-Niri - Listen to iio-sensor-proxy and update niri output orientation depending on the accelerometer orientation.
• nfsm - Fullscreen manager for niri.
• niri-companion - A toolkit that adds extra functionality to niri.
• niri-float-sticky - A utility to make floating windows visible across all workspaces in niri — similar to "sticky windows" in other compositors.
• niri-scratchpad - Scratchpad support for niri.
• niri-screen-time - A utility that collects information about how much time you spend in each application.
• niri-session-manager - Automatically save and restore windows in the niri Wayland compositor.
• niri-settings - Basic configuration GUI for niri.
• niri-switch - A fast task switcher for niri — similar to Alt-Tab known from Windows, Gnome, KDE Plasma etc.
• niri-tag - A single workspace, tag-based window management system for niri, featuring full IPC for shell integrations.
• nirinit - Session manager for niri that automatically saves and restores your window layout.
• niriswitcher - An application switcher for niri, with support for workspaces and automatic dark mode.
• Nirius - Utility commands for the niri.
• nsticky - A utility to make windows visible across all workspaces in niri.
• pandora - Parallax-scrolling wallpaper daemon for Wayland.
• Stasis - A modern Wayland idle manager with smart timeouts, media awareness, and app-specific inhibition.
• swaytreesave - CLI to save and load your compositors tree/layout.
• system76-scheduler-niri - A simple daemon to update the foreground process of system76-scheduler based on the focused window in niri.
• vim-niri-nav - Seamless navigation between niri windows and (neo)vim splits with the same key bindings.
• wayvid - A dynamic video wallpaper engine for Wayland compositors, with priority support for Hyprland and niri.

Scripts

• ndrop - Emulate tdrop in niri.
• niri tweaks - A collection of scripts. Notably includes a script which allows tiling N windows before scrolling new ones.
• niri-scripts - A collection of scripts. Notably allows setting wallpaper per workspace.

Bars and Widgets

• 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-autoname-workspaces - Display icons in your bar for running programs.
• niri_window_buttons - A Waybar module for displaying and managing traditional window buttons in the niri compositor.
• Waybar - Highly customizable Wayland bar based on GTK.
• waybar-niri-windows - A module for Waybar that displays a focus indicator for the current niri 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 for niri and Hyprland created with Ignis.
• IgnisNiriShell - An Ignis based shell for niri.
• niri-caelestia-shell - Port of caelestia dots Quickshell setup for niri.
• Noctalia - A sleek and minimal desktop shell thoughtfully crafted for niri and Hyprland, 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 - CachyOS is a Arch Linux based distribution focused around gaming, performance, and being user-friendly. It provides niri as an install option via its installer.
• Okimarchy - An Omarchy fork that adds support for niri alongside Hyprland, with runtime switching and unified theming.
• Pika OS - PikaOS is a Debian sid based Linux distribution focused on gaming and performance optimization, which provides a niri edition ISO.

Rices

• Setup Showcase - A showcase of niri setups, where users can share their configurations and get inspiration from others.