Kieran's opinionated (and probably slightly dumb) nix config
1# tuigreet
2
3Configures greetd with tuigreet as the login greeter. Exposes nearly every tuigreet CLI flag as a typed Nix option.
4
5## Options
6
7All options under `atelier.apps.tuigreet`:
8
9### Core
10
11| Option | Type | Default | Description |
12|--------|------|---------|-------------|
13| `enable` | bool | `false` | Enable tuigreet |
14| `command` | string | `"Hyprland"` | Session command to run after login |
15| `greeting` | string | *(unauthorized access warning)* | Greeting message |
16
17### Display
18
19| Option | Type | Default | Description |
20|--------|------|---------|-------------|
21| `time` | bool | `false` | Show clock |
22| `timeFormat` | string | `"%H:%M"` | Clock format |
23| `issue` | bool | `false` | Show `/etc/issue` |
24| `width` | int | `80` | UI width |
25| `theme` | string | `""` | Theme string |
26| `asterisks` | bool | `false` | Show asterisks for password |
27| `asterisksChar` | string | `"*"` | Character for password masking |
28
29### Layout
30
31| Option | Type | Default | Description |
32|--------|------|---------|-------------|
33| `windowPadding` | int | `0` | Window padding |
34| `containerPadding` | int | `1` | Container padding |
35| `promptPadding` | int | `1` | Prompt padding |
36| `greetAlign` | enum | `"center"` | Greeting alignment: `left`, `center`, `right` |
37
38### Session management
39
40| Option | Type | Default | Description |
41|--------|------|---------|-------------|
42| `remember` | bool | `false` | Remember last username |
43| `rememberSession` | bool | `false` | Remember last session |
44| `rememberUserSession` | bool | `false` | Per-user session memory |
45| `sessions` | string | `""` | Wayland session search path |
46| `xsessions` | string | `""` | X11 session search path |
47| `sessionWrapper` | string | `""` | Session wrapper command |
48
49### User menu
50
51| Option | Type | Default | Description |
52|--------|------|---------|-------------|
53| `userMenu` | bool | `false` | Show user selection menu |
54| `userMenuMinUid` | int | `1000` | Minimum UID in user menu |
55| `userMenuMaxUid` | int | `65534` | Maximum UID in user menu |
56
57### Power commands
58
59| Option | Type | Default | Description |
60|--------|------|---------|-------------|
61| `powerShutdown` | string | `""` | Shutdown command |
62| `powerReboot` | string | `""` | Reboot command |
63
64### Keybindings
65
66| Option | Type | Default | Description |
67|--------|------|---------|-------------|
68| `kbCommand` | enum | `"F2"` | Key to switch command |
69| `kbSessions` | enum | `"F3"` | Key to switch session |
70| `kbPower` | enum | `"F12"` | Key for power menu |