Next: , Previous: Hooks, Up: Top


11 The Status Bar

ratpoison presents status and output through the status bar. By default it is located in the top right corner of the screen.

This chapter presents commands for manipulating the status bar.

Since it is the only visible evidence that ratpoison is running (as opposed to the invisible evidence including the lack of title bars and your favorite desktop background) there are also copious visual customizations available for those rainy days.

— Command: lastmsg

Display the last message.

— Command: echo text

Display text as a message.

— Command: set msgwait n

Set the bar's timeout in seconds.

When called with no arguments, the current setting is returned.

— Command: set inputwidth n

Set the width of the input window.

When called with no arguments, the current setting is returned.

— Command: set font font

Set the font. font is a font string like `9x15bold'.

When called with no arguments, the current setting is returned.

— Command: set framefmt fmt

Set the text that appears when the curframe command is called. fmt is a format string that accepts the same format characters as set winfmt.

— Command: set fgcolor color

Set the foreground color for all text ratpoison displays. color is any valid X11 color.

When called with no arguments, the current setting is returned.

— Command: set bgcolor color

Set the background color for all text ratpoison displays. color is any valid X11 color.

When called with no arguments, the current setting is returned.

— Command: set fwcolor color

Set the border color for the focused window. is any valid X11 color.

When called with no arguments, the current setting is returned.

— Command: set bwcolor color

Set the border color for unfocused windows. is any valid X11 color.

When called with no arguments, the current setting is returned.

— Command: set framemsgwait n

Set the duration the `Current frame' indicator is shown. If seconds is zero, wait until the next interactive command. If seconds is -1, don't show any message.

When called with no arguments, the current setting is returned.

— Command: set barpadding x y

Set the horizontal and vertical padding inside the bar.

When called with no arguments, the current setting is returned.

— Command: set bargravity g

Set the default alignment for the message bar. See the gravity command.

When called with no arguments, the current setting is returned.

— Command: set barborder n

Set the border width for the bar window.

When called with no arguments, the current setting is returned.

— Command: set barinpadding n

Set whether the bar window appears at the edge of the screen when there is padding – that is, within the "padding" area – or whether it appears at the edge of the window area. "1" represents the former, "0" the latter. See the set padding and set bargravity commands.

When called with no arguments, the current setting is returned.