FvwmPager(1)

Okay bestie, gather round 🎀 this is the FvwmPager(1) page from the General Commands Manual, and it is giving main character energy ✨

✨ NAME ✨

FvwmPager is the FVWM Pager module, and honestly it's iconic 💅

---

✨ SYNOPSIS ✨

Okay so FvwmPager gets spawned by fvwm, which means typing it into a command line is a total no-go 🙅 no cap. Inside your .fvwmrc file, it gets spawned like this:

Module FvwmPager 0 3

Or you can add it to an fvwm pop-up menu:

Popup "Module-Popup"
     Title     "Modules"
     Module    "GoodStuff"    GoodStuff
     Module    "NoClutter"    FvwmClean
     Module    "FvwmIdentify" FvwmIdent
     Module  "Banner"        FvwmBanner
     Module    "Debug"        FvwmDebug
     Module  "SaveDesktop"   FvwmSave
     Module  "Pager"         FvwmPager 0 3
EndPopup

Where 0 is the first desktop to show, and 3 is the last 🧚

---

✨ DESCRIPTION ✨

The FvwmPager module shows a tiny little miniature view of the Fvwm desktops you list on the command line 🌸 It's super useful for remembering where your active windows are. Windows in the pager get the same color as their fvwm decorations, so it's giving coordinated 🎨

The pager can be used to change your viewport into the current desktop, to switch desktops, or to move windows around. Literally so versatile 💖

Pressing mouse button 1 in the pager changes your viewport to the selected page of the selected desk. If you click button 1 in the desk-label area, you switch desks but not pages within the desk.

Dragging mouse button 2 on a miniature window moves that window to wherever you release the mouse, and your viewport stays put 🦋 If you drag the window out of the pager and onto your desktop, a full-size image of it shows up for you to place. There's no way to grab a full-size image and move it back into the pager, sadly 😭 Since some mice don't have button 2, the author made a workaround: hold modifier-1 (usually Alt) and drag with button 3 🫶

Clicking mouse button 3 on a spot within the current desktop moves the viewport to that location, but it won't snap the viewport to a page boundary. Dragging button 3 moves the viewport as you drag. Button 3 operations are limited to the current desktop only, bestie, so keep that in mind 👑

When iconified, the pager works as a fully functional current-page-only pager ✨ You can move windows and viewports around inside the icon of the pager. Just make sure you don't have any lines like this in your .fvwmrc files:

Warning, bestie 💀: do not have anything similar to this in your .fvwmrc files: Icon "Fvwm Pager" whatever

---

✨ COPYRIGHTS ✨

The FvwmClean program, and the concept for interfacing this module to the Window Manager, are all original work by Robert Nation 💜

Copyright 1994, Robert Nation. No guarantees, warranties, or anything else are provided or implied in any way whatsoever. Use this program at your own risk 🙈 Permission to use this program for any purpose is given, as long as the copyright is kept intact.

---

✨ INITIALIZATION ✨

During initialization, FvwmPager will eventually search a configuration file that describes the time-outs and actions to take. It's the same file fvwm used during its own initialization 🧚

If the FvwmPager executable is linked to another name, like with ln -s FvwmPager OtherPager, then another module called OtherPager can be started with a completely different configuration than FvwmPager. You just change the keyword FvwmPager to OtherPager. This way, multiple pager programs can be used at once, which is lowkey genius 🌈

---

✨ KEYBOARD FOCUS CONTROL ✨

You can direct the keyboard focus to any window on the current desktop by clicking button 2 on its image in the pager 🎀 The window doesn't need to be visible, but it does need to be on the current page.

---

✨ INVOCATION ✨

The invocation method was already shown in the SYNOPSIS section, so scroll up bestie 🙈

---

✨ CONFIGURATION OPTIONS ✨

FvwmPager reads the same .fvwmrc file that fvwm reads when it starts up, and it looks for these configuration options. Iconic 👑

• *FvwmPagerGeometry geometry — Completely or partially sets the pager window's location and geometry, in standard X11 notation. To keep the aspect ratio undistorted, you might want to leave out either the width or the height in the geometry spec 📐
• *FvwmPagerRows rows — Tells fvwm how many rows of desks to use when laying out the pager window 🍓
• *FvwmPagerColumns columns — Tells fvwm how many columns of desks to use when laying out the pager window 🍓
• *FvwmPagerIconGeometry geometry — Sets a size (optional) and location (optional) for the pager's icon window. There's no easy way for FvwmPager to figure out the height of the icon's label, so you'll need to make an allowance for it when using negative y-coordinates in the icon location spec. (Negative y-coordinates are used to place the icon relative to the bottom of the screen instead of the top.) 🧐
• *FvwmPagerStartIconic — Makes the pager start iconified 🦋
• *FvwmPagerFont font-name — Picks the font used to label the desktops. If font_name is "none", then no desktop labels get displayed 🙅
• *FvwmPagerSmallFont font-name — Picks the font used to label the window names in the pager. If you don't specify one, the window labels get omitted. Honestly, window labels seem pretty useless for desktop scales of 32 or greater 💀
• *FvwmPagerFore color — Sets the color used to write the desktop labels and to draw the page-grid lines 🎨
• *FvwmPagerBack color — Sets the background color for the window 🌸
• *FvwmPagerHilight color — The active page and desk label get highlighted with this background pattern instead of the normal background ✨
• *FvwmPagerLabel desk label — Assigns a text label to the desk desk in the pager window. It's super useful for giving your desktops symbolic names 💅

For the *FvwmPagerLabel option, it looks like this:

*FvwmPagerLabel 1 Mail
*FvwmPagerLabel 2 Maker
*FvwmPagerLabel 2 Matlab

• DeskTopScale number — If the geometry isn't specified, a desktop reduction factor gets used to calculate the pager's size. Things in the pager window are shown at 1/number of their actual size 🔥

---

✨ AUTHOR ✨

Robert Nation 👑

---

Bestie, that's the whole FvwmPager tea ☕ Straight from the 3rd Berkeley Distribution, dated Mar 16 1994, and filed under FvwmPager(1) 🦋 love you, mwah 🫶💖