.\" Generated by scdoc 1.11.3 .\" 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" "2024-06-03" .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-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 Antoine POPINEAU .\& .PP Contributed to by great people at https://github.\&com/apognu/tuigreet/graphs/contributors.\& .PP .SH DEVELOPMENT .PP Issue reporting and development discussion should happen at https://github.\&com/apognu/tuigreet.\& .PP .SH SEE ALSO .PP \fBgreetd\fR(1)