> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/niri-wm/niri/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome to niri

> A scrollable-tiling Wayland compositor with a focus on usability and performance

niri is a scrollable-tiling Wayland compositor that offers a unique approach to window management. Instead of traditional tiling layouts with fixed positions, niri arranges windows in columns that you can scroll through horizontally, creating an infinite workspace paradigm.

## Why niri?

<CardGroup cols={2}>
  <Card title="Getting Started" icon="rocket" href="/getting-started">
    Install niri and get it running on your system in minutes
  </Card>

  <Card title="Essential Software" icon="puzzle-piece" href="/important-software">
    Learn about notification daemons, portals, and other required components
  </Card>

  <Card title="Configuration" icon="sliders" href="/configuration/introduction">
    Customize niri to match your workflow and preferences
  </Card>

  <Card title="Xwayland Support" icon="window" href="/features/xwayland">
    Run X11 applications like Steam and Discord on niri
  </Card>
</CardGroup>

## Quick Overview

niri provides a scrollable-tiling window management experience where:

* **Windows are organized in columns** that can contain multiple windows stacked vertically
* **Scroll horizontally** through your workspace to access more columns
* **Dynamic layouts** adjust automatically as you add and remove windows
* **Full Wayland support** with modern features like variable refresh rate and screen recording

<Note>
  niri is not a complete desktop environment. You'll need additional software like notification daemons, portals, and authentication agents for full desktop functionality. See the [Essential Software](/important-software) page for details.
</Note>

## Key Features

* **Scrollable tiling layout**: Infinite horizontal workspace with columnar organization
* **Multiple monitors**: Full multi-monitor support with independent workspaces
* **Wayland native**: Built for modern Wayland protocols and features
* **Customizable**: Extensive configuration options via KDL config files
* **Desktop integration**: Works with portals, screen sharing, and Flatpak apps
* **Compositor effects**: Animations, rounded corners, and blur effects

## Getting Help

<CardGroup cols={2}>
  <Card title="Matrix Chat" icon="comments" href="https://matrix.to/#/#niri:matrix.org">
    Join our community chat for real-time help and discussion
  </Card>

  <Card title="Contributing" icon="code-branch" href="https://github.com/niri-wm/niri/blob/main/CONTRIBUTING.md">
    Learn how to contribute to niri development and documentation
  </Card>
</CardGroup>

## Ready to Start?

Head over to the [Getting Started](/getting-started) guide to install niri and begin your scrollable-tiling journey.

<Tip>
  If you're looking for a more out-of-the-box experience, consider installing niri with [DankMaterialShell](https://github.com/AvengeMedia/DankMaterialShell), which provides a complete desktop shell with panels, notifications, and more.
</Tip>