SYSTEMD-PTY-FORWARD(1) systemd-pty-forward SYSTEMD-PTY-FORWARD(1)

.SH "NAME" systemd-pty-forward - Run a command with a custom terminal background color or title

.SH "SYNOPSIS"

.HP 480u

**systemd-pty-forward**  
\[OPTIONS...]  
{COMMAND}

.SH "DESCRIPTION"

.PP **systemd-pty-forward** can be used to run a command with a custom terminal background color or title.

.SH "OPTIONS"

.PP The following options are understood:

.PP **--background=COLOR**

Change the terminal background color to the specified ANSI color as long as the command runs. The color specified should be an ANSI X3.64 SGR background color, i.e. strings such as 40, 41, ..., 47, 48;2;..., 48;5;.... See **ANSI Escape Code (Wikipedia)**\[1] for details.

Example: --background=44 for a blue background.

Added in version 258.

.RE

.PP **--title=TITLE**

Change the terminal title to the specified string as long as the command runs.

Added in version 258.

.RE

.PP **--quiet**, **-q**

Suppresses additional informational output while running.

Added in version 258.

.RE

.PP **--read-only**

Do not accept any user input on standard input.

Added in version 258.

.RE

.PP **-h**, **--help**

Print a short help text and exit.

.RE  
.PP **--version**

Print a short version string and exit.

.RE

# [NOTES](#NOTES)

1\.

ANSI Escape Code (Wikipedia)

https://en.wikipedia.org/wiki/ANSI\_escape\_code#SGR\_(Select\_Graphic\_Rendition)\_parameters

systemd 262.2

---

Document: systemd-pty-forward(1) from systemd 262.2-r1 (Chainguard OS)
Source: https://github.com/systemd/systemd