aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorIvan Molodetskikh <yalterz@gmail.com>2025-08-27 14:20:22 +0300
committerIvan Molodetskikh <yalterz@gmail.com>2025-08-27 17:27:04 +0300
commitd9833fc1c3de306f500662471ae001094813dbd5 (patch)
treedbb6fda6cef43036d2923c9d58d0fe33e3763f17 /docs
parentdfcd5e9497419646e7f69b99b7340e9f03267dd5 (diff)
downloadniri-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.md16
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).