RPWS(1)

✨ RPWS(1) ✨

okay bestie, so this is a page from the User Contributed Perl Documentation section of the manual 💅 and it's literally about rpws — the thing that gives ratpoison multiple workspaces. no cap. let's get into it 🫶

---

🌸 NAME 🌸

rpws — bestie, it implements multiple workspaces in ratpoison. that's the whole vibe. ✨

---

🎀 SYNOPSIS 🎀

like, here's how you actually talk to it:

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 current           - print the current workspace
rpws help              - this documentation
rpws n                 - switch to this workspace

so like — -a sets up command aliases, -k sets up key bindings and aliases, and yeah you can do both at once if you're feeling ✨ambitious✨.

---

💖 DESCRIPTION 💖

rpws gives you multiple workspaces in ratpoison by making calls to fdump and freestore. it was adapted from rpws which comes with ratpoison in the contrib directory. so it's lowkey a glow-up of an original 🦋

---

👑 USAGE 👑

first things first, bestie — drop this line into ~/.ratpoisonrc:

exec /path/to/rpws init 6 -k

this creates 6 aliases: rpws1, rpws2, etc. and it also binds the keys M-F1, M-F2, etc. to each rpwsN alias. the way that works is genuinely iconic.

moreover, rpwsn (Next) and rpwsp (Prev) are created, and C-M-{Right,Left} are bound to rpws{n,p}. and then — not me being obsessed with this part — aliases rpwsm1, rpwsm2, etc. and rpwsm{n,p} are used to move the focused window to another workspace. main character window behavior fr fr 💅

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-M-S-F$i       Move window to workspace $i
C-M-greater     Move current window to next workspace
C-M-less        Move current window to prev workspace

---

🗂️ FILES 🗂️

rpws requires use of a lockfile, no exceptions bestie 🔒 it defaults to using /tmp/rpws.<UID>.lock but you can change that by setting the environment variable RPWS_LOCKFILE to your desired lockfile. slay, customizable.

lowkey important: it requires the lockfile. that's not optional energy.

---

🧚 AUTHOR 🧚

Mike O'Connor <stew@vireo.org> — thank you for your service king 🫶

---

💜 COPYRIGHT 💜

Copyright (c) 2005 Mike O'Connor All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

okay the caps lock on WITHOUT ANY WARRANTY is doing a lot of heavy lifting there but it means it, bestie 😭

---

and that's the whole page 💖 this was perl v5.28.1, dated 2019-01-30, filed under RPWS(1). periodt. go set up ur workspaces and thrive ✨🌈🎀