tuigreet - A graphical console greeter for greetd

Authors

       Maintained by Antoine POPINEAU <antoine@popineau.eu>.

       Contributed to by great people at https://github.com/apognu/tuigreet/graphs/contributors.

Development

       Issue reporting and development discussion should happen at https://github.com/apognu/tuigreet.

Name

       tuigreet - A graphical console greeter for greetd

Options

-h,--help
Show usage and exit.

-v,--version
Print program version and exit.

-d,--debug[FILE]
Enables debug logging to the provided FILE path, or to /tmp/tuigreet.log if no file is specified.

-c,--cmdCMD
Specify which command to run on successful authentication. This can be overridden by manual selection
within tuigreet.

-s,--sessionsDIR1[:DIR2]...
Location of desktop-files to be used as Wayland session definitions. By default, Wayland sessions are
fetched from /usr/share/wayland-sessions.

--session-wrapper'CMD[ARGS]...'
Specify a wrapper command to execute instead of the session for non-X11 sessions. This command will
receive the session command as its arguments.

-x,--xsessionsDIR1[:DIR2]...
Location of desktop-files to be used as X11 session definitions. By default, X11 sessions are fetched
from /usr/share/xsessions.

--xsession-wrapper'CMD[ARGS]...'
Specify a wrapper command to initialize X server and launch X11 sessions. By default, startx/usr/bin/env will be prepended to all X11 session commands.

--no-xsession-wrapper
Do not wrap commands for X11 sessions.

-w,--widthCOLS
Number of columns the main prompt area should take on the screen.

-i,--issue
Print the content of /etc/issue at the top of the prompt area.

This option is mutually exclusive with --greeting.

-g,--greetingGREETING
Specify the text to be displayed at the top of the prompt area.

This option is mutually exclusive with --issue.

-t,--time
Print the current date and time at the top of the screen.

--time-formatFORMAT
Configure a custom strftime-compliant format string for the current date and time.

--user-menu
Allow selecting a user from a graphical menu.

--user-menu-min-uid
Minimum UID of the users to display in the selection menu.

--user-menu-max-uid
Maximum UID of the users to display in the selection menu.

-r,--remember
Remember the username of the last successfully opened session, so the username field will be pre-
filled on the next run.

--remember-session
Remember the last selected session, effectively overriding the given --cmd option on subsequent runs.

--remember-user-session
Remember the last opened session, per user (requires --remember).

--themeSPEC
Define colors to be used to draw the UI components. You can find the proper syntax in the project's
README.

--asterisks
Add visual feedback when typing secrets, as one asterisk character for every keystroke. By default,
no feedback is given at all.

--asterisks-charCHARS
Change the default feedback character from an asterisk to a random distribution of the provided
characters.

--window-paddingCOLS
Add spacing between the edge of the screen area the drawing area.

--container-paddingCOLS
Add spacing between the border of the main prompt area and its contents.

--prompt-paddingROWS
Add spacing between form fields.

--greet-align[left|center|right]
Alignment of the greeting text in the main prompt container (default: 'center').

--power-shutdownCMD[ARGS]...
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).

--power-rebootCMD[ARGS]...
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).

--power-no-setsid
Do not prefix power commands with setsid, which is used to detach it from current TTY.

--kb-[command|sessions|power][1-12]
change the default F-key keybindings to access the command, sessions and power menus.