diff options
| author | Ivan Molodetskikh <yalterz@gmail.com> | 2025-08-27 14:20:22 +0300 |
|---|---|---|
| committer | Ivan Molodetskikh <yalterz@gmail.com> | 2025-08-27 17:27:04 +0300 |
| commit | d9833fc1c3de306f500662471ae001094813dbd5 (patch) | |
| tree | dbb6fda6cef43036d2923c9d58d0fe33e3763f17 /docs | |
| parent | dfcd5e9497419646e7f69b99b7340e9f03267dd5 (diff) | |
| download | niri-d9833fc1c3de306f500662471ae001094813dbd5.tar.gz niri-d9833fc1c3de306f500662471ae001094813dbd5.tar.bz2 niri-d9833fc1c3de306f500662471ae001094813dbd5.zip | |
wiki/Integrating-niri: Add desktop components section
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/wiki/Integrating-niri.md | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/docs/wiki/Integrating-niri.md b/docs/wiki/Integrating-niri.md index 1b588da6..db00dfda 100644 --- a/docs/wiki/Integrating-niri.md +++ b/docs/wiki/Integrating-niri.md @@ -42,3 +42,19 @@ If this is inconvenient, you can also add [`spawn-at-startup`](./Configuration:- <sup>Since: next release</sup> Niri works with the [Orca](https://orca.gnome.org) screen reader. Please see the [Accessibility](./Accessibility.md) page for details and advice for accessibility-focused distributions. + +### Desktop components + +You very likely want to run at least a notification daemon, portals, and an authentication agent. +This is detailed on the [Important Software](./Important-Software.md) page. + +On top of that, you may want to preconfigure some desktop shell components to make the experience less barebones. +Niri's default config spawns [Waybar](https://github.com/Alexays/Waybar), which is a good starting point, but you may want to consider changing its default configuration to be less of a kitchen sink, and adding the `niri/workspaces` module. +You will probably also want a desktop background tool ([swaybg](https://github.com/swaywm/swaybg) or [swww](https://github.com/LGFae/swww)), and a nicer screen locker (compared to the default `swaylock`), like [hyprlock](https://github.com/hyprwm/hyprlock/). + +Alternatively, some desktop environments and shells work with niri, and can give a more cohesive experience in one package: + +- [LXQt](https://lxqt-project.org/) officially supports niri, see [their wiki](https://github.com/lxqt/lxqt/wiki/ConfigWaylandSettings#general) for details on setting it up. +- Many [XFCE](https://www.xfce.org/) components work on Wayland, including niri. See [their wiki](https://wiki.xfce.org/releng/wayland_roadmap#component_specific_status) for details. +- There are complete desktop shells based on Quickshell that support niri, for example [DankMaterialShell](https://github.com/AvengeMedia/DankMaterialShell) and [Noctalia](https://github.com/noctalia-dev/noctalia-shell). +- You can run a [COSMIC](https://system76.com/cosmic/) session with niri using [cosmic-ext-extra-sessions](https://github.com/Drakulix/cosmic-ext-extra-sessions). |
