niri

Configure Niri on NixOS with Home Manager for scrollable-tiling Wayland desktops.

21|Updated Jan 5, 2024
One-click install
npx skills add https://github.com/olafkfreund/nixos_config --skill niri
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: niri
Source: https://github.com/olafkfreund/nixos_config/tree/main/.gemini/skills/niri
Command: npx skills add https://github.com/olafkfreund/nixos_config --skill niri

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Configuring the Niri Wayland compositor on NixOS can be intricate due to its scrollable-tiling paradigm, per-monitor strips, and the need for declarative integration with Home Manager and flakes. This Skill provides a guided setup, best practices, and ready-to-use templates to streamline installation, configuration, and troubleshooting.

Core Features & Use Cases

  • Declarative Niri config via niri-flake or Home Manager modules.
  • Per-monitor scrollable tiling with dynamic workspaces.
  • Native screenshot/screencast support and no-default-keybindings emphasis.
  • Integration guidance for workflows, validation, and deployment.

Quick Start

Use the niri-flake template to enable programs.niri in your config and run a rebuild to apply the changes.

Frequently Asked Questions about niri

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Niri on NixOS using Home Manager?

To configure Niri on NixOS with Home Manager, you use the niri-flake or NixOS modules to declaratively manage your scrollable-tiling Wayland desktop environment. This approach leverages Nix to validate, deploy, and manage your configuration.

Does the Niri Wayland compositor support multi-monitor setups with dynamic workspaces?

Yes, Niri supports multi-monitor environments with dynamic workspaces and per-monitor window strips. The declarative configuration allows you to define and manage these scrollable-tiling features directly within your NixOS setup.

What do I need to set up a declarative Niri Wayland desktop on NixOS?

You need Nix, NixOS, Home Manager, and the niri-flake tooling to validate, deploy, and manage the configuration. These tools provide the declarative infrastructure required to apply your scrollable-tiling desktop settings.

How does scrollable-tiling in Niri handle per-monitor window strips?

Scrollable-tiling in Niri organizes windows into per-monitor strips with dynamic workspaces, creating a continuous horizontal or vertical layout. You configure this behavior declaratively using niri-flake or Home Manager modules.

Are default keybindings enabled in Niri when configured declaratively?

No, Niri emphasizes a no-default-keybindings approach when configured declaratively. You must manually define your keybindings within the niri-flake or Home Manager configuration to control your scrollable-tiling workflow.

Can I configure native screenshot and screencast support for Niri on NixOS?

Yes, you can configure native screenshot and screencast support for Niri on NixOS. The Skill provides integration guidance to set up these features within your declarative niri-flake or Home Manager configuration.