Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/YaLTeR/niri
A scrollable-tiling Wayland compositor.
https://github.com/YaLTeR/niri
rust smithay tiling-window-manager wayland wayland-compositor
Last synced: 3 months ago
JSON representation
A scrollable-tiling Wayland compositor.
- Host: GitHub
- URL: https://github.com/YaLTeR/niri
- Owner: YaLTeR
- License: gpl-3.0
- Created: 2023-08-10T10:53:14.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-05-01T15:08:49.000Z (6 months ago)
- Last Synced: 2024-05-02T03:26:10.718Z (6 months ago)
- Topics: rust, smithay, tiling-window-manager, wayland, wayland-compositor
- Language: Rust
- Homepage: https://matrix.to/#/#niri:matrix.org
- Size: 1.64 MB
- Stars: 2,007
- Watchers: 22
- Forks: 46
- Open Issues: 58
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/YaLTeR/niri - Scrollable-tiling Wayland WM (Jump To / Linux)
- awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/YaLTeR/niri - Scrollable-tiling Wayland WM (Jump To / Linux)
- awesome-github-repos - YaLTeR/niri - A scrollable-tiling Wayland compositor. (Rust)
README
niri
A scrollable-tiling Wayland compositor.
Getting Started | Configuration | Setup Showcase
## About
Windows are arranged in columns on an infinite strip going to the right.
Opening a new window never causes existing windows to resize.
Every monitor has its own separate window strip.
Windows can never "overflow" onto an adjacent monitor.
Workspaces are dynamic and arranged vertically.
Every monitor has an independent set of workspaces, and there's always one empty workspace present all the way down.
The workspace arrangement is preserved across disconnecting and connecting monitors where it makes sense.
When a monitor disconnects, its workspaces will move to another monitor, but upon reconnection they will move back to the original monitor.
## Features
- Scrollable tiling
- Dynamic workspaces like in GNOME
- Built-in screenshot UI
- Monitor and window screencasting through xdg-desktop-portal-gnome
- You can [block out](https://github.com/YaLTeR/niri/wiki/Configuration:-Window-Rules#block-out-from) sensitive windows from screencasts
- [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
- Configurable layout: gaps, borders, struts, window sizes
- [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)
- Live-reloading config
## Video Demo
https://github.com/YaLTeR/niri/assets/1794388/bce834b0-f205-434e-a027-b373495f9729
## Status
A lot of the essential functionality is implemented, plus some goodies on top.
Feel free to give niri a try: follow the instructions on the [Getting Started](https://github.com/YaLTeR/niri/wiki/Getting-Started) wiki page.
Have your [waybar]s and [fuzzel]s ready: niri is not a complete desktop environment.
Note that NVIDIA GPUs may have issues.
## Inspiration
Niri is heavily inspired by [PaperWM] which implements scrollable tiling on top of GNOME Shell.
One of the reasons that prompted me to try writing my own compositor is being able to properly separate the monitors.
Being a GNOME Shell extension, PaperWM has to work against Shell's global window coordinate space to prevent windows from overflowing.
## Contact
We have a Matrix chat, feel free to join and ask a question: https://matrix.to/#/#niri:matrix.org
[PaperWM]: https://github.com/paperwm/PaperWM
[waybar]: https://github.com/Alexays/Waybar
[fuzzel]: https://codeberg.org/dnkl/fuzzel