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.
- --env KEY=VALUE
-
Environment variables to run the default session with (can appear more then once).
- -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.
- -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 NotAShelf <[email protected]>.
Contributed to by great people at https://github.com/NotAShelf/tuigreet/graphs/contributors.
DEVELOPMENT
Issue reporting and development discussion should happen at https://github.com/NotAShelf/tuigreet.