# niri

## Docs

- [Welcome to niri](https://mintlify.wiki/niri-wm/niri/introduction.md): A scrollable-tiling Wayland compositor with a focus on usability and performance
- [Getting Started](https://mintlify.wiki/niri-wm/niri/getting-started.md): Install and configure niri on your system
- [Essential Software](https://mintlify.wiki/niri-wm/niri/important-software.md): Required and recommended software for a complete niri desktop experience
- [Workspaces](https://mintlify.wiki/niri-wm/niri/concepts/workspaces.md): Learn about niri's dynamic workspace system that moves between monitors
- [Overview](https://mintlify.wiki/niri-wm/niri/concepts/overview.md): A zoomed-out view of your workspaces and windows for easier navigation
- [Tabs](https://mintlify.wiki/niri-wm/niri/concepts/tabs.md): Switch columns to display windows as tabs instead of vertical tiles
- [Floating Windows](https://mintlify.wiki/niri-wm/niri/concepts/floating-windows.md): Manage windows that float on top of the tiled layout
- [Fullscreen and Maximize](https://mintlify.wiki/niri-wm/niri/concepts/fullscreen-and-maximize.md): Different ways to make windows fill the screen in niri
- [Gestures](https://mintlify.wiki/niri-wm/niri/concepts/gestures.md): Mouse, touchpad, and touchscreen gestures for navigating niri
- [Configuration Introduction](https://mintlify.wiki/niri-wm/niri/configuration/introduction.md): Learn how to configure niri with KDL configuration files
- [Configuration Overview](https://mintlify.wiki/niri-wm/niri/configuration/overview.md): Overview of niri configuration structure and organization
- [Input Configuration](https://mintlify.wiki/niri-wm/niri/configuration/input.md): Configure keyboards, mice, touchpads, and other input devices in niri
- [Output Configuration](https://mintlify.wiki/niri-wm/niri/configuration/outputs.md): Configure monitors, resolution, refresh rate, and positioning in niri
- [Key Bindings](https://mintlify.wiki/niri-wm/niri/configuration/key-bindings.md): Configure keyboard shortcuts, mouse bindings, and scroll bindings in niri
- [Switch Events](https://mintlify.wiki/niri-wm/niri/configuration/switch-events.md): Configure laptop lid close/open and tablet mode event handlers in niri
- [Layout Configuration](https://mintlify.wiki/niri-wm/niri/configuration/layout.md): Configure window positioning, sizing, gaps, borders, focus ring, and visual effects in niri
- [Window Rules](https://mintlify.wiki/niri-wm/niri/configuration/window-rules.md): Configure behavior and appearance for specific windows using matchers and properties
- [Layer Rules](https://mintlify.wiki/niri-wm/niri/configuration/layer-rules.md): Configure behavior for individual layer-shell surfaces in niri
- [Animations](https://mintlify.wiki/niri-wm/niri/configuration/animations.md): Configure animation behavior in niri compositor
- [Gestures](https://mintlify.wiki/niri-wm/niri/configuration/gestures.md): Configure gesture settings in niri compositor
- [Recent Windows](https://mintlify.wiki/niri-wm/niri/configuration/recent-windows.md): Configure the recent windows switcher (Alt-Tab) in niri
- [Named Workspaces](https://mintlify.wiki/niri-wm/niri/configuration/named-workspaces.md): Create persistent named workspaces in niri
- [Include Files](https://mintlify.wiki/niri-wm/niri/configuration/include.md): Split your niri configuration across multiple files
- [Debug Options](https://mintlify.wiki/niri-wm/niri/configuration/debug-options.md): Debugging and experimental options for niri compositor
- [Miscellaneous Options](https://mintlify.wiki/niri-wm/niri/configuration/miscellaneous.md): Top-level configuration options in niri that don't have dedicated pages
- [Accessibility](https://mintlify.wiki/niri-wm/niri/features/accessibility.md): Screen readers and accessibility features in niri
- [Screencasting](https://mintlify.wiki/niri-wm/niri/features/screencasting.md): Record your screen, individual windows, and use advanced screencasting features in niri
- [Xwayland](https://mintlify.wiki/niri-wm/niri/features/xwayland.md): Running X11 applications in niri using xwayland-satellite and other methods
- [IPC (Inter-Process Communication)](https://mintlify.wiki/niri-wm/niri/features/ipc.md): Communicate with niri programmatically using the IPC socket and niri msg commands
- [Integrating niri](https://mintlify.wiki/niri-wm/niri/integration/integrating-niri.md): Essential information for integrating niri in a Linux distribution
- [Layer Shell Components](https://mintlify.wiki/niri-wm/niri/integration/layer-shell-components.md): Important considerations for bars, launchers, and other layer-shell components in niri
- [Example systemd Setup](https://mintlify.wiki/niri-wm/niri/integration/example-systemd-setup.md): Learn how to set up desktop components as systemd services with niri
- [NVIDIA GPU Issues](https://mintlify.wiki/niri-wm/niri/troubleshooting/nvidia.md): Troubleshooting guide for running niri with NVIDIA graphics cards
- [Application-Specific Issues](https://mintlify.wiki/niri-wm/niri/troubleshooting/application-issues.md): Solutions for common issues with specific applications running on niri
- [Frequently Asked Questions](https://mintlify.wiki/niri-wm/niri/troubleshooting/faq.md): Common questions and answers about using niri
- [Developing niri](https://mintlify.wiki/niri-wm/niri/development/developing-niri.md): Guide for developing and testing niri locally, including running builds, logging, testing, and profiling
- [Packaging niri](https://mintlify.wiki/niri-wm/niri/development/packaging-niri.md): Guidelines for packaging niri for Linux distributions, including build features, file installation, dependencies, and testing
- [Design Principles](https://mintlify.wiki/niri-wm/niri/development/design-principles.md): Core design principles and philosophy guiding niri's development and user experience
- [Animation Timing](https://mintlify.wiki/niri-wm/niri/development/animation-timing.md): How niri implements frame-perfect animation timing aligned to monitor refresh cycles
- [Fractional Layout](https://mintlify.wiki/niri-wm/niri/development/fractional-layout.md): Understanding how niri handles fractional scaling and physical pixel alignment
- [Redraw Loop](https://mintlify.wiki/niri-wm/niri/development/redraw-loop.md): Understanding niri's output redraw state machine and VBlank handling on TTY
- [Documenting niri](https://mintlify.wiki/niri-wm/niri/development/documenting-niri.md): Guidelines for writing and maintaining niri documentation across GitHub wiki, markdown previews, and the documentation site