LinuxCommandLibrary

sm

Display fullscreen text messages

TLDR

Display a message fullscreen

$ sm "Hello World!"
copy
Display with inverted colors
$ sm -i "Hello World!"
copy
Custom foreground color
$ sm -f blue "Hello World!"
copy
Custom background color
$ sm -b "#008888" "Hello World!"
copy
Rotate display (90 degree increments)
$ sm -r 3 "Hello World!"
copy
Display from pipe input
$ echo "Hello World!" | sm -
copy
Kiosk mode (non-interactive)
$ sm -k "Message"
copy

SYNOPSIS

sm [OPTIONS] [text|-]

DESCRIPTION

sm (screen-message) displays text as large as possible on the screen, automatically scaling to fill the available space. It creates a fullscreen window with the message, useful for presentations, signage, or displaying information at events.
In interactive mode, users can edit the displayed text by typing. Press Escape to clear text, Ctrl-I to invert colors, and Ctrl-Q or double-Escape to quit. When reading from stdin with -, the display updates at form-feed characters (\f).

PARAMETERS

-f, --foreground color

Set text color (name or hex code like #RRGGBB)
-b, --background color
Set background color
-i, --invert
Swap foreground and background colors
-r, --rotate n
Rotate display (n * 90 degrees counterclockwise)
-k, --kiosk
Non-interactive mode (ignores input except Ctrl-Q)
-n, --font fontspec
Specify font family
-a, --align alignment
Text alignment: 0=center, 1=left, 2=right
-m, --markup
Enable Pango markup XML formatting
-
Read text from standard input
-h, --help
Display help
-V, --version
Display version

CAVEATS

Requires a graphical display (X11 or Wayland). Text size adjusts automatically; very long messages result in smaller fonts. Interactive editing is disabled in kiosk mode. Font availability depends on system installation.

HISTORY

sm (screen-message) was created by Joachim Breitner (nomeata) as a simple display utility. It has been used at Debian conferences and other events for photo displays and signage. The tool is available for Linux, Windows, and as a web application. Released under GPL-2.0 license.

SEE ALSO

figlet(6), toilet(1), banner(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community