{"id":15026180,"url":"https://github.com/yalter/niri","last_synced_at":"2025-05-14T09:01:59.735Z","repository":{"id":187487377,"uuid":"676934005","full_name":"YaLTeR/niri","owner":"YaLTeR","description":"A scrollable-tiling Wayland compositor.","archived":false,"fork":false,"pushed_at":"2025-04-18T08:57:48.000Z","size":6454,"stargazers_count":6809,"open_issues_count":155,"forks_count":228,"subscribers_count":27,"default_branch":"main","last_synced_at":"2025-04-18T21:46:36.764Z","etag":null,"topics":["rust","smithay","tiling-window-manager","wayland","wayland-compositor"],"latest_commit_sha":null,"homepage":"https://matrix.to/#/#niri:matrix.org","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/YaLTeR.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"YaLTeR"}},"created_at":"2023-08-10T10:53:14.000Z","updated_at":"2025-04-18T18:12:04.000Z","dependencies_parsed_at":"2023-10-03T14:05:25.954Z","dependency_job_id":"c7519a3a-1a86-41d6-9523-153f8d1221b0","html_url":"https://github.com/YaLTeR/niri","commit_stats":null,"previous_names":["yalter/niri"],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YaLTeR%2Fniri","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YaLTeR%2Fniri/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YaLTeR%2Fniri/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YaLTeR%2Fniri/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YaLTeR","download_url":"https://codeload.github.com/YaLTeR/niri/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250250785,"owners_count":21399704,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["rust","smithay","tiling-window-manager","wayland","wayland-compositor"],"created_at":"2024-09-24T20:03:57.333Z","updated_at":"2025-04-22T13:43:05.246Z","avatar_url":"https://github.com/YaLTeR.png","language":"Rust","funding_links":["https://github.com/sponsors/YaLTeR"],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eniri\u003c/h1\u003e\n\u003cp align=\"center\"\u003eA scrollable-tiling Wayland compositor.\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://matrix.to/#/#niri:matrix.org\"\u003e\u003cimg alt=\"Matrix\" src=\"https://img.shields.io/badge/matrix-%23niri-blue?logo=matrix\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/YaLTeR/niri/blob/main/LICENSE\"\u003e\u003cimg alt=\"GitHub License\" src=\"https://img.shields.io/github/license/YaLTeR/niri\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/YaLTeR/niri/releases\"\u003e\u003cimg alt=\"GitHub Release\" src=\"https://img.shields.io/github/v/release/YaLTeR/niri?logo=github\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/YaLTeR/niri/wiki/Getting-Started\"\u003eGetting Started\u003c/a\u003e | \u003ca href=\"https://github.com/YaLTeR/niri/wiki/Configuration:-Overview\"\u003eConfiguration\u003c/a\u003e | \u003ca href=\"https://github.com/YaLTeR/niri/discussions/325\"\u003eSetup\u0026nbsp;Showcase\u003c/a\u003e\n\u003c/p\u003e\n\n![niri with a few windows open](https://github.com/user-attachments/assets/d142e57d-a25d-4ddb-ab46-311417458211)\n\n## About\n\nWindows are arranged in columns on an infinite strip going to the right.\nOpening a new window never causes existing windows to resize.\n\nEvery monitor has its own separate window strip.\nWindows can never \"overflow\" onto an adjacent monitor.\n\nWorkspaces are dynamic and arranged vertically.\nEvery monitor has an independent set of workspaces, and there's always one empty workspace present all the way down.\n\nThe workspace arrangement is preserved across disconnecting and connecting monitors where it makes sense.\nWhen a monitor disconnects, its workspaces will move to another monitor, but upon reconnection they will move back to the original monitor.\n\n## Features\n\n- Built from the ground up for scrollable tiling\n- [Dynamic workspaces](https://github.com/YaLTeR/niri/wiki/Workspaces) like in GNOME\n- Built-in screenshot UI\n- Monitor and window screencasting through xdg-desktop-portal-gnome\n    - You can [block out](https://github.com/YaLTeR/niri/wiki/Configuration:-Window-Rules#block-out-from) sensitive windows from screencasts\n- [Touchpad](https://github.com/YaLTeR/niri/assets/1794388/946a910e-9bec-4cd1-a923-4a9421707515) and [mouse](https://github.com/YaLTeR/niri/assets/1794388/8464e65d-4bf2-44fa-8c8e-5883355bd000) gestures\n- Group windows into [tabs](https://github.com/YaLTeR/niri/wiki/Tabs)\n- Configurable layout: gaps, borders, struts, window sizes\n- [Gradient borders](https://github.com/YaLTeR/niri/wiki/Configuration:-Layout#gradients) with Oklab and Oklch support\n- [Animations](https://github.com/YaLTeR/niri/assets/1794388/ce178da2-af9e-4c51-876f-8709c241d95e) with support for [custom shaders](https://github.com/YaLTeR/niri/assets/1794388/27a238d6-0a22-4692-b794-30dc7a626fad)\n- Live-reloading config\n\n## Video Demo\n\nhttps://github.com/YaLTeR/niri/assets/1794388/bce834b0-f205-434e-a027-b373495f9729\n\n## Status\n\nNiri is stable for day-to-day use and does most things expected of a Wayland compositor.\nMany people are daily-driving niri, and are happy to help in our [Matrix channel].\n\nGive it a try!\nFollow the instructions on the [Getting Started](https://github.com/YaLTeR/niri/wiki/Getting-Started) wiki page.\nHave your [waybar]s and [fuzzel]s ready: niri is not a complete desktop environment.\n\nHere are some points you may have questions about:\n\n- **Multi-monitor**: yes, a core part of the design from the very start. Mixed DPI works.\n- **Fractional scaling**: yes, plus all niri UI stays pixel-perfect.\n- **NVIDIA**: seems to work fine.\n- **Floating windows**: yes, starting from niri 25.01.\n- **Input devices**: niri supports tablets, touchpads, and touchscreens.\nYou can map the tablet to a specific monitor, or use [OpenTabletDriver].\nWe have touchpad gestures, but no touchscreen gestures yet.\n- **Wlr protocols**: yes, we have most of the important ones like layer-shell, gamma-control, screencopy.\nYou can check on [wayland.app](https://wayland.app) at the bottom of each protocol's page.\n- **Performance**: while I run niri on beefy machines, I try to stay conscious of performance.\nI've seen someone use it fine on an Eee PC 900 from 2008, of all things.\n- **Xwayland**: no built-in support, but xwayland-satellite is [easy to set up](https://github.com/YaLTeR/niri/wiki/Xwayland#using-xwayland-satellite) and works very well.\n    - Steam and games, including Proton: work perfectly through xwayland-satellite.\n    - JetBrains IDEs, Ghidra: work well through xwayland-satellite.\n    - Discord and other Electron apps: work well through xwayland-satellite.\n    - Chromium and VSCode: work perfectly natively on Wayland with the right flags.\n    - X11 apps that want to position windows or bars at specific screen coordinates: won't work well; you can run them in a nested compositor like [labwc](https://github.com/YaLTeR/niri/wiki/Xwayland#using-the-labwc-wayland-compositor) or [rootful Xwayland](https://github.com/YaLTeR/niri/wiki/Xwayland#directly-running-xwayland-in-rootful-mode).\n    - Display scaling (integer or fractional) will make X11 apps look blurry; this needs to be supported in xwayland-satellite.\n    For games, you can run them in [gamescope] at native resolution, even with display scaling.\n\n## Inspiration\n\nNiri is heavily inspired by [PaperWM] which implements scrollable tiling on top of GNOME Shell.\n\nOne of the reasons that prompted me to try writing my own compositor is being able to properly separate the monitors.\nBeing a GNOME Shell extension, PaperWM has to work against Shell's global window coordinate space to prevent windows from overflowing.\n\n## Tile Scrollably Elsewhere\n\nHere are some other projects which implement a similar workflow:\n\n- [PaperWM]: scrollable tiling on top of GNOME Shell.\n- [karousel]: scrollable tiling on top of KDE.\n- [papersway]: scrollable tiling on top of sway/i3.\n- [hyprscroller] and [hyprslidr]: scrollable tiling on top of Hyprland.\n- [PaperWM.spoon]: scrollable tiling on top of macOS.\n\n## Media\n\n[niri: Making a Wayland compositor in Rust](https://youtu.be/Kmz8ODolnDg?list=PLRdS-n5seLRqrmWDQY4KDqtRMfIwU0U3T)\n\nMy talk from the 2024 Moscow RustCon about niri, and how I do randomized property testing and profiling, and measure input latency.\nThe talk is in Russian, but I prepared full English subtitles that you can find in YouTube's subtitle language selector.\n\n## Contact\n\nWe have a Matrix chat, feel free to join and ask a question: https://matrix.to/#/#niri:matrix.org\n\n[PaperWM]: https://github.com/paperwm/PaperWM\n[waybar]: https://github.com/Alexays/Waybar\n[fuzzel]: https://codeberg.org/dnkl/fuzzel\n[karousel]: https://github.com/peterfajdiga/karousel\n[papersway]: https://spwhitton.name/tech/code/papersway/\n[hyprscroller]: https://github.com/dawsers/hyprscroller\n[hyprslidr]: https://gitlab.com/magus/hyprslidr\n[PaperWM.spoon]: https://github.com/mogenson/PaperWM.spoon\n[Matrix channel]: https://matrix.to/#/#niri:matrix.org\n[OpenTabletDriver]: https://opentabletdriver.net/\n[gamescope]: https://github.com/ValveSoftware/gamescope\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyalter%2Fniri","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyalter%2Fniri","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyalter%2Fniri/lists"}