abort (C-tC-g) Do nothing and that successfully. (Useful if you pressed C-t in error).
addhookeventcommand
Add a hook: run command whenever event is called. Possible events are:
deletewindow
Run after a window is withdrawn.
newwindow
Run after a new window is mapped.
key Run whenever a top level key is pressed (by default C-t).
quit Run before exiting ratpoison.
restart
Run before restarting ratpoison.
switchframe
Run after a frame actually switched, but before the window in it is focused.
switchgroup
Run after selecting a new group.
switchscreen
Run when the user switches to a different screen.
switchwin
Run after a new window is selected. (With dedication, it may already be inactive again,
if it was put into another frame)
aliasaliascommand
Add alias as new way to call command.
bindkeycommand
alias for "definekeyrootkeycommand"
banish (C-tb) Banish the rat cursor to the lower right corner of the screen.
banishrel
Banish the rat cursor to the lower right corner of the current window. If there isn't a window
in the current frame, it banishes the rat cursor to the lower right corner of the frame.
chdir [directory]
If the optional argument is given, change the current directory of ratpoison to directory. If
nothing is given, change it to the value of the environment variable "HOME".
clrunmanaged
Clears the unmanaged window list.
cnext Like next but switch to the next window with another resource class than the current one. (That
means the next window belonging to another type of application than the current one.)
cprev Like prev but switch to the previous window with another resource class than the current one.
(That means the previous window belonging to another type of application than the current one.)
colonratpoison-command (C-t:)
Execute ratpoison-command interactively. (i.e. ask for possible missing arguments.)
cother Like other but switch to the window of the current group that was last accessed and has another
resource class but is not currently visible.
curframe (C-tF)
Show a bar marking the current frame.
definekeykeymapkeycommand
Add a new key binding in keymap for key to execute command. Default keymaps are top normally
only containing C-t, which reads a key from root, containing all the normal commands.
Note that you have to describe ":" by "colon", "!" by "exclam" and so on. If you cannot guess a
name of a key, try either C-tkey and look at the error message, or try :describekeyroot and
pressing the key.
dedicate [0 | 1]
Consider the current frame dedicated/chaste (1) or promiscuous (0).
A dedicated frame will not accept new windows. When new windows are to be focused, they will be
opened in a non-dedicated frame instead.
If no argument is given, toggle the current dedicateness. By default no windows are dedicated.
delete (C-tk)
Close the current window.
delkmapkeymap
Deletes the keymap named keymap, that was generated with newkmap. The keymaps top (or whatever
was specified by settopkmap) and root cannot be deleted.
describekeykeymap
Grab the next key. Similar to readkey, describekey shows only the command in keymap, that would
be executed by readkey.
echotext
Show text as ratpoison message.
escapekey
Update the default escape key to key.
Strictly speaking it updates the readkeyroot command in the keymap top to key, the other binding
in root to key, and meta binding in root to key without modifiers or C-key if key has no
modifiers. (If settopkmap was called with an argument other than top that will be used instead
of top.)
exchangedown (C-tC-Down)
Exchange the window in the current frame with the window in the frame below the current frame.
exchangeleft (C-tC-Left)
Exchange the window in the current frame with the window in the frame left of the current frame.
exchangeright (C-tC-Right)
Exchange the window in the current frame with the window in the frame right of the current frame.
exchangeup (C-tC-Up)
Exchange the window in the current frame with the window in the frame above the current frame.
execshell-command (C-t!)
Spawn a shell executing shell-command.
execashell-command
Spawn a shell executing shell-command, without remembering the current frame, so that _NET_WM_PID
declaring programs will be placed into the frame active when they open a window instead of the
frame active when ratpoison gets this command.
execfframeshell-command
Spawn a shell executing shell-command, showing _NET_WM_PID supporting programs in the given frame
instead of the frame selected when this program is run.
fdump [screenno]
Output the defining data for all frames of the current screen, or for screen number screenno if
this is specified.
focus (C-tTab)
Focus the next frame.
focuslast
Switch to the last selected focus.
focusleft (C-tLeft)
Switch to the frame to the left of the current one.
focusdown (C-tDown)
Switch to the frame beneath the current one.
focusright (C-tRight)
Switch to the frame to the right of the current one.
focusprev
Focus the previous frame.
focusup (C-tUp)
Switch to the frame above the current one.
frestoreframes
Replace the current frames with the ones specified in frames in the format as generated by fdump.
fselect [frameno] (C-tf)
If an argument is supplied, switch to a frame given by number frameno.
If no argument is given, show a frame selector in each frame and wait for a key to be pressed.
If the key matches an existing frame selector, this frame gets focused.
Frame selectors are by default the numbers starting with zero, but they can be changed by setting
framesels.
gdelete [group]
If the optional argument group is supplied, delete group. Otherwise delete the current group. If
the last group is deleted, a new group with name default is created. The group has to be empty,
otherwise it cannot be deleted.
getenvvariable
Output the value of the environment variable variable.
getsel Paste the current X Selection into the current window.
gmergegroup
Move all windows from group group into the current group.
gmovegroup
Move the current window into group group.
gnewgroup
Create a new group with name group and select it. Most window commands only see (and thus
select, consider next, previous or last) windows within the group active when they are issued.
gnewbggroup
Create a new group named group, but do not select it.
gnext Select the next group. Most window commands only see windows in the effective group.
gnumber [oldnew]
Give the number new to the group with the number old or the current group.
gother Select the last accessed group. Most window commands only see windows in the effective group.
gprev Select the prior group. Most window commands only see windows in the effective group.
gravity [nw | w | sw | n | c | s | ne | e | se]
Change how in its frame the current window is aligned.
grename
Rename current group.
groups Output a list of all groups with their number.
gselectgroup
Select the group named group.
help [keymap]
If the optional parameter keymap is given, list all keybindings in this keymap, otherwise list
all key bindings in keymap root.
hsplit [l/p | [-]pixels] (C-tS)
Split the current frame into left frame and a right frame. If no parameter is given, split in
halves. If two numbers separated by a slash (‘/’) are given, the left one is l times the pth
part and the right one (p-l) times the pth part of the prior width. Otherwise the right half
is pixels wide or the left one is pixels wide, depending whether there is ‘-’ in front of the
number or not.
inext Like next but switch to the next window with the same resource class as the current one. (That
means the next window belonging to the same application as the current one.)
info (C-ti)
Output the current the width, height, window number and window name of the current window. (What
name means is chosen by “setwinname”.)
iprev Like prev but switch to the previous window with the same resource class as the current one.
(That means the previous window belonging to the same application as the current one.)
iother Like other but switch to the window of the current group that was last accessed and has the same
resource class but is not currently visible.
kill (C-tK)
Close the X-connection of the X-client responsible for the current window.
lastmsg (C-tm)
Reshow the last message.
license (C-tV)
Show ratpoison's license.
linkkey [keymap]
Do what key is bound to in the keymap keymap if supplied. Otherwise what key is bound to in
keymap root.
listhookevent
List all commands specified with addhook to be executed when even event occurs.
meta [key] (C-tt)
Send the escape key (that which normally is C-t) to the current window. If a key is specified,
this is sent instead. Note that some applications by default ignore the synthetic key that is
sent using this command as it is considered a security hole. xterm is one such application.
msgwait [seconds]
Set the duration the message window is shown. If seconds is zero, wait infinitely. This command
is deprecated, please set the msgwait variable instead.
newkmapkeymap
Generate a new keymap named keymap. This keymap can be used to add new key-command mappings to
it with definekey and can be called with readkey.
newwmnew-window-manager
Quit ratpoison and execute new-window-manager instead.
next (C-tReturn | C-tn | C-tspace)
Switch to the next window in the current group.
nextscreen (C-tN)
Switch to the next screen. (If you have multiple physical ones.)
numbernew [old]
Give the number new to the window with the number old or the current window.
only (C-tQ)
Remove all frames on the current screen except the current frame and maximize this one to the
size of the whole screen.
other (C-tC-t)
Switch to the window of the current group that was last accessed but is not currently visible.
prev (C-tp)
Switch to the previous window in the current group.
prevscreen (C-tP)
Switch to the previous screen. (If you have multiple physical ones.)
prompt [prompt]
ratpoison will ask the user for input, showing prompt (or a single colon, if no argument is
given) and output the input the user has made. Note that this command probably does not make
much sense in interactive mode.
putselx-selection
Replace the X selection with the text x-selection. It can be inserted into the current window
with getsel.
quit Quit ratpoison.
ratinfo
Display the x y coordinates of the rat cursor relative to the screen.
ratrelinfo
Display the x y coordinates of the rat cursor relative to the current window or current frame if
no window is focused
ratwarpxy
Move the rat cursor to the position (x, y).
ratrelwarpdeltaxdeltay
Move the rat cursor to (deltax, deltay), relative to the current position.
ratclick [button]
Simulate a rat click with button (button 1=left button if none given).
rathold {up | down} [button]
Simulate pressing|releasing rat button button (1=left button if none given).
readkeykeymap
Grab the next key pressed, and execute the command associated to this key in keymap. To show it
is waiting for a key, ratpoison will change the rat cursor to a square if waitcursor is set.
This command is perhaps best described with its usage in the default configuration: by pressing
C-t, which is the only key in the keymap top , the command "readkeyroot" is executed. The next
key then executes the command in keymap root belonging to this command.
redisplay (C-tl)
Extend the current window to the whole size of its current frame and redisplay it. (Useful to
redisplay normal windows or bring transient windows to the full size of the frame as only normal
windows are maximized by ratpoison)
redo (C-tU)
Revert the last undo of frame changes.
remhookeventcommand
Remove command command from the list of commands to be called when event event is hit. (The
command has to specified, as an event can have multiple commands attached to it.) Use "listhookhook" to get a list of all attached commands.
remove (C-tR)
Remove the current frame and extend some frames around to fill the remaining gap.
removedown (C-tM-Down)
Kill frames directly below the current frame, extending the current frame as much as possible.
removeleft (C-tM-Left)
Kill frames directly left of the current frame, extending the current frame as much as possible.
removeup (C-tM-Up)
Kill frames directly above the current frame, extending the current frame as much as possible.
removeright (C-tM-Right)
Kill frames directly right of the current frame, extending the current frame as much as possible.
resize [deltaxdeltay] (C-tr)
If deltax and deltay are supplied, resize the current frame by that (i.e. move the bottom right
corner by the given offsets and then move this frame and resize adjacent frames to make the
frames fill the whole screen again.)
If in interactive mode no arguments are supplied, resize the current frame interactively:
Return finish resizing
C-g, Escape abort resizing
C-n, Down, j grow vertically
C-p, Up, k shrink vertically
C-f, Right, l grow horizontally
C-b, Up, h shrink horizontally
s shrink to size of current window
While resizing interactively, changes are in multiples of the amount of pixels given by setresizeunit (by default 10).
restart
Restart ratpoison.
rudeness [rudeness]
This command is deprecated, please use the rudeness variable instead.
sdump Output the list of all screens. The screens are separated by commas. Each screen is shown as 6
values: its number, its x-coordinate, its y-coordinate, its width, its height and if it is
currently selected (1=true, 0=false).
select {- | name | number} (C-t')
If a number is given, switch to the window with number number. If a name is given, switch to the
window in the current group with name name. Blank the current frame, if - is given.
set [variable [value]]
If no argument is given, output all ratpoison variables and their values.
If one argument is given, output the value of ratpoison variable variable. Otherwise set
variable to value. What values are valid depends on the variable. See the section “VARIABLES”
later in this document for details.
setenvvariablevalue
Set the environment variable variable to value. (Environment variables will be passed to all
programs started from ratpoison.)
sfdump Output all frames similar to fdump, but not limited to one screen, but all screens at once and
with the screen number after each frame.
sfrestoreframes
Replace the current frames with the ones specified in frames in the format as generated by
sfdump.
shrink Shrink the current frame to the size of the current window with in.
split [split] (C-ts)
alias for vsplitsourcefile
Read file and execute each line as ratpoison command.
sselectscreennumber
Switch to the screen screennumber. (If you have multiple physical ones.)
startup_message {on | off}
Select whether ratpoison will show a startup message or not. This command is deprecated, please
use the startupmessage variable instead.
swapdest-frame [src-frame] (C-tx)
Exchange the window in src-frame (or the current frame if there is no second argument) with the
window dest-frame (or ask interactively which frame to swap with if there is no argument).
time (C-ta)
Output current data and time.
titlenewname (C-tA)
Overwrite the title of the current window with newname. All following ratpoison commands will
only know the window under the new name.
tmpwmtmpwm
Temporarily give control over to the other window manager tmpwm, reclaiming control when that WM
terminates.
unaliasalias
Remove the alias alias.
unbindkey
alias for
undefinekeyrootkeyundefinekeykeymapkey
Remove the binding for key from keymap.
undo (C-t_, C-tu)
Un-do the last change to the frameset. (Like splitting, resizing, deleting, ...)
The amount of steps that can be undone is specified by the variable maxundos.
unmanage [name]
Add name to the list of unmanaged windows. Thus, windows of this name will not be managed but
allowed to choose their position themselves.
In non-interactive mode calling it without arguments will print the list.
The list can be cleared again by calling clrunmanaged.
unsetenvvariable
Remove variable variable from the list of environment variables.
verbexeccmdline
Spawn a shell executing cmdline after showing a message with the command.
version (C-tv)
Output version and compile time information.
vsplit [l/p | pixels-from-top | -pixels-from-bottom] (C-ts)
Split the current frame into upper frame and a lower frame. If no parameter is given, split in
halves. If two numbers separated by a slash (“/”) are given, the upper one is l times the pth
part and the lower one (p-l) times the pth part of the prior height. Otherwise the lower one
is pixelsfrombottom wide or the upper one pixelsfromtop high, depending whether there is a
“-” in front of the number or not.
warp {on | off}
Select if focusing a window moves the rat cursor to the place it had been last time this window
was focused, or not. This command is deprecated, please set the warp variable instead.
windows [format] (C-tw)
In interactive mode, show the list of all windows in the current group for the duration specified
by the variable msgwait. If msgwait was zero, toggle between indefinitely showing and not
showing.
The messages are shown in columns or rows depending on the value of winliststyle in the format
set by setwinfmt. The following substitutions happen in format:
%a application name (resource name)
%c resource class
%f frame number
%g gravity of the window
%h height of the window
%H unit to resize the window vertically (height_inc)
%i X Window ID
%p process ID
%l last access number
%M string Maxsize, if it specifies a maximum size
%n window number
%s window status (‘*’ is active window, ‘+’ would be chosen by other, ‘-’ otherwise)
%S screen number
%t window name (see setwinname),
%T the string “Transient”, if it is a transient window
%w width of the window
%W unit to resize the window horizontally (width_inc)
%x xine screen number
%% litteral ‘%’
Additionally there can be a positive decimal integer number between the percent sign and the
format string to specify the length this value should be truncated to if longer. (For example:
%20t)
In non-interactive mode, output the list of windows in the current group line by line. The format
string can be overwritten by the optional parameter format.
Install Now
Emojis
PNG Icons
