Salix WebsiteDocumentation Site

4.2.7. Using workspaces

If you have several terminals open, and various browser windows and some other applications, the number of windows may become unwieldy. To help with this, Ratpoison allows you to use workspaces. (In the online Ratpoison manual, these are referred to more precisely as "groups".) You might then put all browser windows in one workspace, for instance.

C-t w lists the windows in the current workspace; C-t W shows four more workspaces, which were set up in the last line of the configuration file. In a console, type rpws help .

$ rpws help
     rpws init n [-k] [-a]  - setup rpws with n workspaces.
                                -a sets up command aliases;
                                -k sets up key bindings and aliases.
     rpws dump <fname>      - dumps the current layout to <fname>
     rpws restore <fname>   - restores rpws workspaces from <fname>
     rpws help              - this documentation
     rpws n                 - switch to this workspace

    Add the following line in ~/.ratpoisonrc

         exec /path/to/rpws init 6 -k

    This creates 6 aliases rpws1, rpws2, etc. It also binds the keys
    M-F1, M-F2, etc to each rpwsN alias. Moreover, rpwsn (Next) and
    rpwsp (Prev) are created, and C-M-{Right,Left} are bound to
    rpws{n,p}. Full list of keybindings created are:

        M-F$i           Goto workspace $i
        C-M-Right       Goto Next workspace
        C-M-Left        Goto Prev workspace
        C-t F$i         Move window to workspace $i
        C-t F11         Move current window to prev workspace
        C-t F12         Move current window to next workspace

for more detailed documentation run "perldoc /usr/bin/rpws"

The usage summary you will see may be a little cryptic. Just as C means Control, M refers to Alt. Use Alt with the function keys to access each workspace. Ctrl-Alt and the arrows move up and down workspaces. The remaining options move the current window to a different workspace.