YaLTeR/niri GitHub Repository Summary Overview Project Name: niri Author: YaLTeR Description: A scrollable-tiling Wayland compositor. Main Branch: main License: GPL-3.0 Website: yalter.github.io/niri/ Languages: Primarily written in Rust (98.9%) Key Features Windows arranged in columns on an infinite horizontal strip without resizing existing windows. Each monitor has its own independent window strip; windows do not overflow to adjacent monitors. Dynamic and vertical workspaces, with one empty workspace always present. Workspace arrangement preserved across monitor disconnections and reconnections. Built from the ground up for scrollable tiling. Includes an Overview that zooms out workspaces and windows. Built-in screenshot UI. Monitor and window screencasting with options to block sensitive windows and support for dynamic cast targets. Touchpad and mouse gestures supported; no touchscreen gestures yet. Window grouping into tabs. Configurable layout options: gaps, borders, struts, window sizes, and gradient borders supporting Oklab and Oklch color spaces. Animations with support for custom shaders. Live-reloading configuration. Accessibility features including support for screen readers. Integration of Xwayland via xwayland-satellite starting from niri 25.08. Supports mixed DPI setups and fractional scaling. Stable for day-to-day use, with active daily users. Compatible with NVIDIA. Supports many Wayland protocols including layer-shell, gamma-control, screencopy. Repository Information Stars: 11.9k Forks: 438 Watchers: 40 Contributors: 141 Commits: 2,452 Releases: 21, latest version v25.08 released on August 30, 2025. Directory Structure Highlights .github, docs directories niri-config, niri-ipc, niri-visual-tests directories resources, src directories Various configuration files at root: .gitattributes, .gitignore, CONTRIBUTING.md, README.md, clippy.toml, flake.lock, flake.nix, LICENSE, rustfmt.toml, typos.toml, niri.spec.rpkg Documentation and Resources The README includes: An overview image and demo video. Links for Getting Started, Configuration, and Setup Showcase. Explanation of design philosophy and workspace behavior. Links to supplementary resources such as: Matrix chat channel for community support: https://matrix.to/#/#niri:matrix.org Discord server: https://discord.gg/vT8Sfjy7sx A list of similar scrollable tiling window managers and compositors. Additional media includes: Talk video from 2024 Moscow RustCon with English subtitles. Interview with the developer Ivan. LWN article giving a detailed introduction to niri. Contributing Contributions are welcome, including both coding and non-coding. Guidelines available in CONTRIBUTING.md. Inspiration and Related Projects Inspired heavily by PaperWM, a scrollable tiling GNOME Shell extension. Other related projects listed: PaperWM (GNOME Shell) karousel (KDE) scroll and papersway (sway/i3) hyprscrolling and hyprslidr (Hyprland) PaperWM.spoon (macOS) --- This summary provides a complete picture of the niri project hosted at GitHub user YaLTeR's repository, highlighting its key functionality, usage statistics, documentation, and community resources.