---
name: "tuigreet"
section: "1"
platform: "linux"
package: "greetd-tuigreet"
version: "0.11.1-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/tuigreet"
---

# tuigreet(1)

A graphical console greeter for greetd

## 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.

- **--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 NotAShelf \<git@notashelf.dev\>.

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.

## SEE ALSO

[**greetd**(1)](/greetd/1.md)