.\" Generated by scdoc 1.11.5 .\" Complete documentation for this program is not available as a GNU info page .ie \n(.g .ds Aq \(aq .el .ds Aq ' .nh .ad l .\" Begin generated content: .TH "tuigreet" "1" "2026\-08\-23" .PP .SH NAME .PP tuigreet \- A graphical console greeter for greetd .PP .SH SYNOPSIS .PP \fBtuigreet\fR [OPTIONS].\&.\&.\& .PP .SH OPTIONS .PP \fB\-h, \-\-help\fR .RS 4 Show usage and exit.\& .PP .RE \fB\-v, \-\-version\fR .RS 4 Print program version and exit.\& .PP .RE \fB\-d, \-\-debug [FILE]\fR .RS 4 Enables debug logging to the provided FILE path, or to /tmp/tuigreet.\&log if no file is specified.\& .PP .RE \fB\-c, \-\-cmd CMD\fR .RS 4 Specify which command to run on successful authentication.\& This can be overridden by manual selection within \fBtuigreet\fR.\& .PP .RE \fB\-\-env KEY=VALUE\fR .RS 4 Environment variables to run the default session with (can appear more then once).\& .PP .RE \fB\-s, \-\-sessions DIR1[:DIR2].\&.\&.\&\fR .RS 4 Location of desktop\-files to be used as Wayland session definitions.\& By default, Wayland sessions are fetched from \fB/usr/share/wayland\-sessions\fR.\& .PP .RE \fB\-\-session\-wrapper '\&CMD [ARGS].\&.\&.\&'\&\fR .RS 4 Specify a wrapper command to execute instead of the session for non\-X11 sessions.\& This command will receive the session command as its arguments.\& .PP .RE \fB\-x, \-\-xsessions DIR1[:DIR2].\&.\&.\&\fR .RS 4 Location of desktop\-files to be used as X11 session definitions.\& By default, X11 sessions are fetched from \fB/usr/share/xsessions\fR.\& .PP .RE \fB\-\-xsession\-wrapper '\&CMD [ARGS].\&.\&.\&'\&\fR .RS 4 Specify a wrapper command to initialize X server and launch X11 sessions.\& By default, \fBstartx /usr/bin/env\fR will be prepended to all X11 session commands.\& .PP .RE \fB\-\-no\-xsession\-wrapper\fR .RS 4 Do not wrap commands for X11 sessions.\& .PP .RE \fB\-w, \-\-width COLS\fR .RS 4 Number of columns the main prompt area should take on the screen.\& .PP .RE \fB\-i, \-\-issue\fR .RS 4 Print the content of \fB/etc/issue\fR at the top of the prompt area.\& .PP This option is mutually exclusive with \fB\-\-greeting\fR.\& .PP .RE \fB\-g, \-\-greeting GREETING\fR .RS 4 Specify the text to be displayed at the top of the prompt area.\& .PP This option is mutually exclusive with \fB\-\-issue\fR.\& .PP .RE \fB\-t, \-\-time\fR .RS 4 Print the current date and time at the top of the screen.\& .PP .RE \fB\-\-time\-format FORMAT\fR .RS 4 Configure a custom strftime\-compliant format string for the current date and time.\& .PP .RE \fB\-\-user\-menu\fR .RS 4 Allow selecting a user from a graphical menu.\& .PP .RE \fB\-\-user\-menu\-min\-uid\fR .RS 4 Minimum UID of the users to display in the selection menu.\& .PP .RE \fB\-\-user\-menu\-max\-uid\fR .RS 4 Maximum UID of the users to display in the selection menu.\& .PP .RE \fB\-r, \-\-remember\fR .RS 4 Remember the username of the last successfully opened session, so the username field will be pre\-filled on the next run.\& .PP .RE \fB\-\-remember\-session\fR .RS 4 Remember the last selected session, effectively overriding the given \fB\-\-cmd\fR option on subsequent runs.\& .PP .RE \fB\-\-remember\-user\-session\fR .RS 4 Remember the last opened session, per user (requires \fB\-\-remember\fR).\& .PP .RE \fB\-\-theme SPEC\fR .RS 4 Define colors to be used to draw the UI components.\& You can find the proper syntax in the project'\&s README.\& .PP .RE \fB\-\-asterisks\fR .RS 4 Add visual feedback when typing secrets, as one asterisk character for every keystroke.\& By default, no feedback is given at all.\& .PP .RE \fB\-\-asterisks\-char CHARS\fR .RS 4 Change the default feedback character from an asterisk to a random distribution of the provided characters.\& .PP .RE \fB\-\-window\-padding COLS\fR .RS 4 Add spacing between the edge of the screen area the drawing area.\& .PP .RE \fB\-\-container\-padding COLS\fR .RS 4 Add spacing between the border of the main prompt area and its contents.\& .PP .RE \fB\-\-prompt\-padding ROWS\fR .RS 4 Add spacing between form fields.\& .PP .RE \fB\-\-greet\-align [left|center|right]\fR .RS 4 Alignment of the greeting text in the main prompt container (default: '\¢er'\&).\& .PP .RE \fB\-\-power\-shutdown CMD [ARGS].\&.\&.\&\fR .RS 4 Customize the command run when instructed to shut down the machine.\& This must be a non\-interactive command (sudo cannot prompt for a password, for example).\& .PP .RE \fB\-\-power\-reboot CMD [ARGS].\&.\&.\&\fR .RS 4 Customize the command run when instructed to reboot the machine.\& This must be a non\-interactive command (sudo cannot prompt for a password, for example).\& .PP .RE \fB\-\-power\-no\-setsid\fR .RS 4 Do not prefix power commands with \fBsetsid\fR, which is used to detach it from current TTY.\& .PP .RE \fB\-\-kb\-[command|sessions|power] [1\-12]\fR .RS 4 change the default F\-key keybindings to access the command, sessions and power menus.\& .PP .RE .SH AUTHORS .PP Maintained by NotAShelf .\& .PP Contributed to by great people at https://github.\&com/NotAShelf/tuigreet/graphs/contributors.\& .PP .SH DEVELOPMENT .PP Issue reporting and development discussion should happen at https://github.\&com/NotAShelf/tuigreet.\& .PP .SH SEE ALSO .PP \fBgreetd\fR(1)