1tuigreet(1) General Commands Manual tuigreet(1)
2
3
4
6 tuigreet - A graphical console greeter for greetd
7
9 tuigreet [OPTIONS]...
10
12 -h, --help
13 Show usage and exit.
14
15 -v, --version
16 Print program version and exit.
17
18 -c, --cmd CMD
19 Specify which command to run on successful authentication. This can
20 be overriden by manual selection within tuigreet.
21
22 -s, --sessions DIR1[:DIR2]...
23 Location of desktop-files to be used as session definitions. By de‐
24 fault, sessions are fetched from /usr/share/xsessions and
25 /usr/share/wayland-sessions.
26
27 -w, --width COLS
28 Number of columns the main prompt area should take on the screen.
29
30 -i, --issue
31 Print the content of /etc/issue at the top of the prompt area.
32
33 This option is mutually exclusive with --greeting.
34
35 -g, --greeting GREETING
36 Specify the text to be displayed at the top of the prompt area.
37
38 This option is mutually exclusive with --issue.
39
40 -t, --time
41 Print the current date and time at the top of the screen.
42
43 --time-format FORMAT
44 Configure a custom strftime-compliant format string for the current
45 date and time.
46
47 --user-menu
48 Allow selecting a user from a graphical menu.
49
50 --user-menu-min-uid
51 Minimum UID of the users to display in the selection menu.
52
53 --user-menu-max-uid
54 Maximum UID of the users to display in the selection menu.
55
56 -r, --remember
57 Remember the username of the last successfully opened session, so
58 the username field will be pre-filled on the next run.
59
60 --remember-session
61 Remember the last selected session, effectively overriding the
62 given --cmd option on subsequent runs.
63
64 --remember-user-session
65 Remember the last opened session, per user (requires --remember).
66
67 --asterisks
68 Add visual feedback when typing secrets, as one asterisk character
69 for every keystroke. By default, no feedback is given at all.
70
71 --asterisks-char CHAR
72 Change the default feedback character from an asterisk to the pro‐
73 vided character.
74
75 --window-padding COLS
76 Add spacing between the edge of the screen area the drawing area.
77
78 --container-padding COLS
79 Add spacing between the border of the main prompt area and its con‐
80 tents.
81
82 --prompt-padding ROWS
83 Add spacing between form fields.
84
85 --power-shutdown CMD [ARGS]...
86 Customize the command run when instructed to shut down the machine.
87 This must be a non-interactive command (sudo cannot prompt for a
88 password, for example).
89
90 --power-reboot CMD [ARGS]...
91 Customize the command run when instructed to reboot the machine.
92 This must be a non-interactive command (sudo cannot prompt for a
93 password, for example).
94
95 --power-no-setsid
96 Do not prefix power commands with setsid, which is used to detach
97 it from current TTY.
98
100 Maintained by Antoine POPINEAU <antoine@popineau.eu>.
101
102 Contributed to by great people at https://github.com/apognu/tui‐
103 greet/graphs/contributors.
104
106 Issue reporting and development discussion should happen at
107 https://github.com/apognu/tuigreet.
108
110 greetd(1)
111
112
113
114 2023-07-22 tuigreet(1)