NAME

       tuigreet - A graphical console greeter for greetd

SYNOPSIS

       tuigreet [OPTIONS]...

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, --cmd CMD
           Specify which command to run on successful authentication. This can be overridden by manual selection
           within tuigreet.

       -s, --sessions DIR1[: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, --xsessions DIR1[: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, --width COLS
           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, --greeting GREETING
           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-format FORMAT
           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).

       --theme SPEC
           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-char CHARS
           Change the default feedback character from an asterisk to  a  random  distribution  of  the  provided
           characters.

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

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

       --prompt-padding ROWS
           Add spacing between form fields.

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

       --power-shutdown CMD [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-reboot CMD [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.

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.

SEE ALSO

       greetd(1)

                                                   2025-01-13                                        tuigreet(1)