Site Tools


hardstatus

Default Keybindings

None.

Syntax

  • hardstatus [on|off]
  • hardstatus [always]lastline|message|ignore [string]
  • hardstatus string [string]

Description

This command configures the use and emulation of the terminal’s hardstatus line. The first form toggles whether screen will use the hardware status line to display messages. If the flag is set to “off”, these messages are overlaid in reverse video mode at the display line. The default setting is “on”.

The second form tells screen what to do if the terminal doesn’t have a hardstatus line (i.e. the termcap/terminfo capabilities hs, ts, fs and ds are not set). If the type “lastline” is used, screen will reserve the last line of the display for the hardstatus. “message” uses screen’s message mechanism and “ignore” tells screen never to display the hardstatus. If you prepend the word “always” to the type (e.g. “alwayslastline”), screen will use the type even if the terminal supports a hardstatus.

The third form specifies the contents of the hardstatus line. “%h” is used as default string, i.e. the stored hardstatus of the current window (settable via “ESC]0;<string>^G”, “ESC_<string>ESC\”, or the hstatus command) is displayed. You can customize this to any string you like including the escapes from the String Escapes chapter. If you leave out the argument string, the current string is displayed.

You can mix the second and third form by providing the string as additional argument.

Examples

hardstatus alwayslastline '%{= kG}[ %{G}%H %{g}][%= %{= kw}%?%-Lw%?%{r}(%{W}%n*%f%t%?(%u)%?%{r})%{w}%?%+Lw%?%?%= %{g}][%{B} %d/%m %{W}%c %{g}]'

See Also


User Tools