From 9950672a28ac65e1bdffab6e763c824d9a7573a4 Mon Sep 17 00:00:00 2001 From: Ivan Molodetskikh Date: Thu, 9 Nov 2023 21:37:07 +0400 Subject: Write out session installation steps in the README --- README.md | 22 ++++++++++++++++++---- 1 file changed, 18 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 795da14a..992da7b6 100644 --- a/README.md +++ b/README.md @@ -31,20 +31,34 @@ Every monitor has an independent set of workspaces, and there's always one empty Niri tries to preserve the workspace arrangement as much as possible upon disconnecting and connecting monitors. When a monitor disconnects, its workspaces will move to another monitor, but upon reconnection they will move back to the original monitor. +## Installation + +The recommended way to install and run niri is as a standalone desktop session. +To do that, put files into the correct directories according to this table. + +| File | Destination | +| ---- | ----------- | +| `target/release/niri` | `/usr/bin/` | +| `resources/niri-session` | `/usr/bin/` | +| `resources/niri.desktop` | `/usr/share/wayland-sessions/` | +| `resources/niri-portals.conf` | `/usr/share/xdg-desktop-portal/` | +| `resources/niri.service` | `/usr/lib/systemd/user/` | + +Doing this will make niri appear in GDM and, presumably, other display managers. + ## Running `cargo run --release` -Inside a desktop session, it will run in a window. +Inside an existing desktop session, it will run in a window. On a TTY, it will run natively. To exit when running on a TTY, press SuperShiftE. ### Session -You can install and run niri as a standalone desktop session. -Check the `generate-rpm` metadata at the bottom of `Cargo.toml` to see which files go where. -After installing, you can choose the niri session in GDM and, presumably, other display managers. +If you followed the recommended installation steps above, niri should appear in your display manager. +Starting it from there will run niri as a desktop session. The niri session will autostart apps through the systemd xdg-autostart target. You can also autostart systemd services like [mako] by symlinking them into `$HOME/.config/systemd/user/niri.service.wants/`. -- cgit