aboutsummaryrefslogtreecommitdiffstats
path: root/desktop/modules/user/README.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-10-16 10:54:49 +0200
committerDanilo M. <danix@danix.xyz>2026-10-16 10:54:49 +0200
commit33a20ad0b33467c6980399bb618485b74d66dc04 (patch)
tree48d20718d9dd80619125082cec90521b107eb6cb /desktop/modules/user/README.md
parent9a2f7cce971bf2dca54794896d083fdd2f2f1110 (diff)
downloadquickshell-33a20ad0b33467c6980399bb618485b74d66dc04.tar.gz
quickshell-33a20ad0b33467c6980399bb618485b74d66dc04.zip
feat(user): a random greeting on each drawer open
The greeting row picks one at random from ~/.config/quickshell/greetings, one per line with {user} for the login name, # comments and blank lines skipped; without the file, five built-in ones. The row is rebuilt on every drawer open, so the file is read then with no watch, and the last pick is kept in User.js, a shared .pragma library, so the same greeting never shows twice running. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'desktop/modules/user/README.md')
-rw-r--r--desktop/modules/user/README.md7
1 files changed, 6 insertions, 1 deletions
diff --git a/desktop/modules/user/README.md b/desktop/modules/user/README.md
index 63670eb..692fb78 100644
--- a/desktop/modules/user/README.md
+++ b/desktop/modules/user/README.md
@@ -1,6 +1,6 @@
# user
-The drawer's greeting row (avatar, `Hello <login>`, real name) and the page
+The drawer's greeting row (avatar, a greeting, real name) and the page
it opens, which edits the user's details where other programs read them.
| Field | Written to |
@@ -17,6 +17,11 @@ stops and from three characters, per its usage policy. Up/Down, Enter and
Escape work the list. Offline, the field is plain text. The Git section
shows the name and email git will get, read-only, and the signing key.
+The greeting is picked at random on each drawer open, never the same one
+twice running, from `~/.config/quickshell/greetings`: one per line, `{user}`
+for the login name, `#` comments and blank lines skipped. Without the file,
+five built-in ones.
+
`userctl` does all reading and writing; the page only calls it. Polkit lets a
user edit their own AccountsService entry without a prompt. A new detail is
one entry in `UserPage.qml`'s `fields` and one `case` in `userctl`.