Node: The Status Bar, Next: , Previous: Hooks, Up: Top



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.

msgwait n Command
Set the bar's timeout in seconds.

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

lastmsg Command
Display the last message.

echo text Command
Display text as a message.

set inputwidth n Command
Set the width of the input window.

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

set font font Command
Set the font. font is a font string like 9x15bold.

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

set framefmt fmt Command
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.

set fgcolor color Command
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.

set bgcolor color Command
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.

set barpadding x y Command
Set the horizontal and vertical padding inside the bar.

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

set bargravity g Command
Set the default alignment for the message bar. See the gravity command.

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

set barborder n Command
Set the border width for the bar window.

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