niri README

The project's README from github.com/niri-wm/niri. As one markdown file: README.md.

niri

A scrollable-tiling Wayland compositor.

Matrix GitHub License GitHub Release

Getting Started | Configuration | Setup Showcase

niri with a few windows open

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

Video Demo

https://github.com/niri-wm/niri/assets/1794388/bce834b0-f205-434e-a027-b373495f9729

Also check out these videos that showcase a lot of the niri functionality:

Status

Niri is stable for day-to-day use and does most things expected of a Wayland compositor. Many people are daily-driving niri, and are happy to help in our Matrix channel.

Give it a try! Follow the instructions on the Getting Started page. Grab a desktop shell like DankMaterialShell or Noctalia (or build a more traditional setup): niri by itself is not a complete desktop environment. Also check out awesome-niri, a list of niri-related links and projects.

Here are some points you may have questions about:

Media

niri: Making a Wayland compositor in Rust · December 2024

My talk from the 2024 Moscow RustCon about niri, and how I do randomized property testing and profiling, and measure input latency. The talk is in Russian, but I prepared full English subtitles that you can find in YouTube's subtitle language selector.

An interview with Ivan, the developer behind Niri · June 2025

An interview by a German tech podcast Das Triumvirat (in English). We talk about niri development and history, and my experience building and maintaining niri.

A tour of the niri scrolling-tiling Wayland compositor · July 2025

An LWN article with a nice overview and introduction to niri.

Contributing

If you'd like to help with niri, there are plenty of both coding- and non-coding-related ways to do so. See CONTRIBUTING.md for an overview.

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.

Tile Scrollably Elsewhere

Here are some other projects which implement a similar workflow:

Contact

Our main communication channel is a Matrix chat, feel free to join and ask a question: https://matrix.to/#/#niri:matrix.org

We also have a community Discord server: https://discord.gg/vT8Sfjy7sx

niri (niri-wm/niri)

Searching Database…

28.5K ·GitHub
Что это такое?niri — это Wayland-композитор с прокручиваемой плиткой (scrollable-tiling) для Linux, написанный на Rust поверх Smithay. Его фирменная идея: окна располагаются колонками на бесконечной ленте, которая прокручивается вправо.
Чем прокручиваемая плитка отличается от обычного тайлового композитора?Открытие нового окна никогда не меняет размер существующих — оно просто добавляет колонку в бесконечную ленту. У каждого монитора своя отдельная лента, поэтому окна никогда не вылезают на соседний монитор, а рабочие пространства динамические и складываются вертикально.
Как его запустить?README отсылает к странице Getting Started с инструкциями по установке. niri — это композитор, поэтому он заменяет ваш сеанс рабочего стола на Linux, а не устанавливается как приложение внутри него.
Нужно ли что-то ещё сверху?Да — сам по себе niri не является полноценной средой рабочего стола. В README предлагается взять готовую оболочку вроде DankMaterialShell или Noctalia либо собрать более традиционную настройку самостоятельно.
Он достаточно стабилен, чтобы пользоваться им каждый день?В README сказано, что niri стабилен для повседневного использования, и многие уже используют его как основной. Шероховатости небольшие: жесты для тачпада есть, а для сенсорного экрана пока нет.
Он запустится на моём железе, например с видеокартой NVIDIA?NVIDIA, по отзывам, работает нормально, мультимониторные конфигурации со смешанным DPI и дробным масштабированием поддерживаются на первом месте, и он нетребователен к ресурсам — кто-то запускает его на Eee PC 900 2008 года.
Что есть из коробки?Обзор (Overview), который отдаляет рабочие пространства, встроенный интерфейс скриншотов, запись экрана с возможностью скрыть чувствительные окна, окна с вкладками, размытие фона, анимации с пользовательскими шейдерами и конфиг с горячей перезагрузкой.
Зачем создавать новый композитор вместо того, чтобы использовать PaperWM?niri сильно вдохновлён PaperWM, но PaperWM — это расширение GNOME Shell, которому приходится бороться с глобальным координатным пространством окон Shell, чтобы окна не вылезали за пределы. Написав собственный композитор, автор с самого начала смог нормально разделить мониторы.
А как насчёт плавающих окон?Поддерживаются — плавающие окна доступны начиная с niri 25.01 наряду с прокручиваемыми колонками.
Поддерживаются ли графические планшеты?Да — niri поддерживает планшеты, тачпады и сенсорные экраны. Планшет можно привязать к конкретному монитору или использовать OpenTabletDriver.
Creator
niri-wm
Size
12.5 MB
Stars
28.5K
Age
3y
Commits · 90 Days