From 0efe90039ab96b73f5252e2f003378b7ab445da1 Mon Sep 17 00:00:00 2001 From: Maximilian Friedersdorff Date: Wed, 21 May 2025 15:59:01 +0100 Subject: [PATCH] Document how to config the greeter --- README.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/README.md b/README.md index a7f37df..93a0d9b 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,33 @@ # Dotfiles Managed with [chezmoi](https://www.chezmoi.io) + +## Greeter + +I use greetd with gtkgreet as the greeter/login manager. Because this is +installed and configured as a system level service, its configuration cannot +be managed by chezmoi. Thankfully, when using cage, it's as straightforward +as using the following configuration file: + +```toml +[terminal] +# The VT to run the greeter on. Can be "next", "current" or a number +# designating the VT. +vt = 1 + +# The default session, also known as the greeter. +[default_session] + +# `agreety` is the bundled agetty/login-lookalike. You can replace `/bin/sh` +# with whatever you want started, such as `sway`. +command = "GTK_THEME='Adwaita:dark' cage -s -- gtkgreet --background /usr/share/backgrounds/archlinux/wild.png --layer-shell" + +# The user to run the command as. The privileges this user must have depends +# on the greeter. A graphical greeter may for example require the user to be +# in the `video` group. +user = "greeter" +``` + +This only requires installing greetd, gtkgreet, cage and the archlinux +backgrounds packages. Unlike the setup with sway, this doesn't require +a loose formation of configuration files.