FVWMPAGER(1)

📦
version 1.1.5 · 5 versions
, in ubuntu stonking

👑 FVWMPAGER ✨

okay bestie, welcome to the manual page for FvwmPager — the fvwm pager module, and yes it ate 💅 (this is a real one, FVWMPAGER(1), and we're doing it properly).

💖 NAME 💖

FvwmPager — the fvwm pager module. that's it, that's the name, iconic 🎀

✨ SYNOPSIS ✨

FvwmPager [ -transient ] [ alias ] [ first desk [ last desk ] ]

ngl, FvwmPager is spawned by fvwm, so no command line invocation will work. you don't just... run it yourself. it's not that kind of girl 🙈

Here's the tea though: FvwmPager displays a miniature view of the fvwm virtual desktop(s), showing all desk numbers between first desk and last desk. So:

  • if last desk is omitted, only the first desk is shown.
  • if both desk numbers are omitted, the current desk is used instead.
  • if you use an asterisk, *, in place of first desk, the pager will always show the current desktop, even when you switch desks. main character behavior fr fr ⭐

If you iconify FvwmPager, its icon on the virtual desktop will be a functional version of the pager only showing the current desktop. cute and useful, we love a multitasker 💅

FvwmPager is launched via the Module FvwmPager command from fvwm's config file, and can be launched from functions, menus, key bindings, and so on. If the pager is started with the -transient option, the next time a button is released the pager is closed.

⚠️ heads up bestie: that -transient option only works if the window style of the pager window is Sticky (go read the fvwm man page, iykyk). You should use the StaysOnTop style too.

The following example shows how to launch two pagers from your config file when fvwm starts. The first is a pager which will show all desks from 0 to 3, and the second is a pager which only shows the current desk. like, two pagers?? obsessed 😭

AddToFunc StartFunction Module FvwmPager 0 3
AddToFunc StartFunction Module FvwmPager *

FvwmPager is configured via an fvwm module configuration alias. If an alias is given, FvwmPager will use the alias for the configuration and name of the window. If no alias is given, the default "FvwmPager" alias is used. See the CONFIGURATION section below for a full list of configuration options. no skipping, bestie, we read the whole thing 📖

🦋 DESCRIPTION 🦋

FvwmPager displays a miniature view of the fvwm virtual desktop(s) showing the position of all windows and pages within each visible desktop. If DeskHilight is set, the location of each monitor within the desktop is also shown. So like — the pager is your reference for where windows and monitors actually are in the virtual desktops. a little map of your whole digital life 🌈

The pager can show labels with the names of the virtual desktops and monitors. The labels can be shown individually or together. By default the desk labels are shown — to disable them use NoDeskLabels. To show the monitor labels, use the MonitorLabels option. The labels can be used as buttons to move the monitors to new desktops. See the LABELS configuration section for more details. they're not just pretty, they're clickable 💅

The mouse can be used to change the current page/desk, to drag windows to new locations, or send windows fvwm commands. The default behavior is:

  • mouse 1 (left button) will switch desk/page a monitor is currently viewing to the area clicked.
  • mouse 2 (middle) can be used to drag windows to new locations or focus them.
  • mouse 3 (right) can Scroll the view port to the location clicked.

The mouse behavior can be configured — which button does what — and you can allow sending custom commands to fvwm. See the MOUSE BEHAVIOUR configuration section below for a more detailed description of mouse behavior and how to customize it. make it yours 🎀

FvwmPager fully supports multiple monitors and fvwm's DesktopConfiguration. The Monitor option can be used to show only the windows and virtual desktop area used by specific monitor. See MONITOR AND DESKTOP CONFIGURATION for details on ways to configure the pager to work with per-monitor or shared desktop configurations. multi-monitor girlies, this one's for you 🖥️✨

When iconified, FvwmPager's icon on the desktop is a fully functional pager that only shows the current desk. This icon pager responds to all the same clicks as described above. This is useful by allowing full pager that shows multiple virtual desktops to be iconified to a smaller pager that only shows the current desk. it's giving pocket-sized pager 🫶

⚠️ Note that the FvwmPager icon must be visible via 'Style FvwmPager Icon', and not overridden, for this to work. do not override her, she's doing her best 😭

FvwmPager will compute its initial window size based on your monitor(s) configuration. By default it makes a pager 1/32 the size of your monitor(s) resolution (see DesktopScale) and matches either the global aspect ratio or a single monitor if Monitor is set. Both the size of the pager (see Geometry) and desktop layout (see Cols and Rows) can be configured. flexible queen 👑

Using the SendToModule fvwm command, some of FvwmPager's configurations can be modified while running. This allows showing/hiding labels, changing which monitor is being tracked, and a few other things. See the SENDING COMMANDS. live edits?? we love a hot-swap 💖

🌸 CONFIGURATION 🌸

FvwmPager is configured via a module configuration alias in fvwm's configuration file. The default alias is "FvwmPager" and can be configured using lines of the form:

*FvwmPager: Option parameters

When FvwmPager is launched with an optional alias, that alias will be used for the configuration instead. For example to start a pager that shows the current desk on a single monitor, use the following:

DestroyModuleConfig FvwmPagerDP2:*
*FvwmPagerDP2: Monitor DP-2
*FvwmPagerDP2: Font None
*FvwmPagerDP2: MiniIcons
AddToFunc StartFunction Module FvwmPager FvwmPagerDP2 *

The full list of configuration options and their parameters are listed below. and bestie, it is A LIST 📋

✨ CONFIGURATION OPTIONS ✨

The configuration options are split into two groups to help organize the large list of configuration options the pager has. (two groups, yes, and yes we're going through all of them, don't even try to scroll past 🙈)

Below you can find configuration options for the GEOMETRY, LABELS, HILIGHTING, WINDOW LOOKS, BALLOON WINDOWS, MOUSE BEHAVIOUR, MONITOR AND DESKTOP CONFIGURATION, DESK STYLES, and MISCELLANEOUS.

📐 GEOMETRY 📐

Configures the size of the pager along with how the desktops are arranged in a grid when viewing more than one desktop. it's the fashion design section of the pager 💅

  • *FvwmPager: Geometry geometry — Completely or partially specifies the pager's window size and location as a geometry string, 'WIDTHxHEIGHT+X+Y'. If both width and height are set, FvwmPager will use that size, and not respect the aspect ratio of the monitors. To maintain an undistorted aspect ratio, set one dimension to zero. For example 400x0 will make a 400 pixel wide window whose height matches the monitors aspect ratio. ✨

If X or Y are included in the geometry string, the pager will open at the specified position. The sign specifies which edge to measure from: +X from the left edge, -X from right edge, +Y from top edge, or -Y from bottom edge. pick your corner, bestie 🎯

  • *FvwmPager: DesktopScale number — If the Geometry is not specified, then a desktop reduction factor is used to calculate the pager's size. The pager will scale a single page to be 1/number of the actual size. The final size of the pager window is then based off the number of pages and/or desks shown. For example, A number of 10 will make each page a tenth of the actual size. A default of 32 is used to size the pager. shrink, but make it fashion 🦋
  • *FvwmPager: Rows rows — FvwmPager can show multiple virtual desktops at once. The desktops can be arranged in a horizontal line (one row, the default behavior), a vertical line (one column), or in a grid with multiple rows and columns. This configures the number of rows used. stack 'em like a little desk lasagna 🍓
  • *FvwmPager: Columns columns — Tells FvwmPager how many columns of desks to use when laying out the grid of desktops. line 'em up 💅
  • *FvwmPager: IconGeometry geometry — Specifies a size (optional) and location (optional) for the pager's icon window. Since there is no easy way for FvwmPager to determine the height of the icon's label, you will have to make an allowance for the icon label height when using negative y-coordinates in the icon location specification (used to specify a location relative to the bottom instead of the top of the screen). lowkey annoying but that's the deal 😭

🎀 LABELS 🎀

FvwmPager can add labels to each virtual desktop shown. The labels can show the name of the desktops and/or the name of the monitors. Labels can be used as buttons to move monitors between virtual desktops. They can be positioned either above or below each desktop. If ShapeLabels is set, only the labels on the current desktop are shown. labels are the accessories of the pager fr 👑

  • *FvwmPager: Font font-name — Specified a font to use to label the desktops. If font_name is "None" then no desktop or monitor labels will be displayed. Note, if MonitorLabels or DeskLabels is used after Font none, the labels will be shown with a default font. she comes back on her own, no cap ✨
  • *FvwmPager: LabelsBelow — Causes the pager to draw desk labels below the corresponding desk. ⬇️
  • *FvwmPager: LabelsAbove — Causes the pager to draw desk labels above the corresponding desk. Useful for canceling the effect of the LabelsBelow option. ⬆️ (yes, it's the undo button for LabelsBelow, love that for her)
  • *FvwmPager: ShapeLabels — Causes the pager to hide the labels of all but the current desk. only the current desk gets the spotlight 🌟
  • *FvwmPager: NoShapeLabels — Causes the pager to show the labels of all visible desks. Useful for canceling the effect of the ShapeLabels option. everyone gets to shine 🫶
  • *FvwmPager: DeskLabels — Tells FvwmPager to display a label for each desk. If LabelHilight is set, the active desk will be highlighted. This is the default state, but this is useful for undoing Font none or NoDeskLabels. the comeback arc 💖
  • *FvwmPager: NoDeskLabels — Tells FvwmPager to not display desk labels. bye girl 💀
  • *FvwmPager: MonitorLabels — Tells FvwmPager to display a row of monitor labels. If LabelHilight is set, the monitor label on the desktop the monitor is currently viewing will be highlighted using the hilight color. Clicking on a monitor label will move that monitor to the selected desktop. This option is goes well with 'DesktopConfiguration shared' to be able to control which monitor is moved to a selected desktop. this one's the moment — click a label, yeet a monitor to a new desk 🔥
  • *FvwmPager: NoMonitorLabels — Tells FvwmPager to not display monitor labels, the default state. 🙈

💜 HILIGHTING 💜

FvwmPager will highlight the current location of each monitor in the virtual desktop. This can highlight both the area inside the desk, and the desk labels. Which labels are highlighted is a combination of the DesktopConfiguration and the below options. the ✨glow-up✨ section

  • *FvwmPager: DeskHilight — Highlight the area shown by all active monitors with the current highlight color/pixmap. The default behavior. ⭐
  • *FvwmPager: NoDeskHilight — Don't highlight the active monitor location. 🙅♀️
  • *FvwmPager: LabelHilight — Highlight the label of the current monitor and/or desk. What is highlighted depends on a combination of what DesktopConfiguration is used and which labels are shown. This is the default state. 👑
  • *FvwmPager: NoLabelHilight — Don't highlight the current labels. This is useful when using pixmaps or transparent colorsets, to remove the filled rectangle on the highlighted label. glossy girlies, this one's for you 💅

okay that's the first chunk bestie — more coming, don't go anywhere 💖

🎀 WINDOW LOOKS 🎀

So like, these options are the ✨glow-up✨ controls for how your mini windows look — labels, borders, mini icons, and what to do when windows are teensy. By default windows use the foreground (that's borders + labels) and the background from the colorset fvwm is using. Wanna do custom colors? Scroll down to DESK STYLES, bestie, it's all there. 💅

  • *FvwmPager: WindowFont font-name — sets the font for labeling the mini windows in the pager. If you don't set it, or you set it to "None", the labels just... don't happen. And ngl, window labels are often WAY bigger than the mini window has room for, because mini windows are tiny tiny and window names are like a whole paragraph 😭. Good news: BALLOON WINDOWS (below) can be set up to pop up a label when your mouse hovers over the window. Also, for backwards compatibility, SmallFont is an alias for this option — iconic, we love a legacy queen.
  • *FvwmPager: WindowLabelFormat format — this is the printf()-style format for the mini window labels. Flags you can use: %t, %i, %c, and %r — for the window's title, icon title, class, or resource name. Default is "%i". 🦋
  • *FvwmPager: WindowBorderWidth n — the width of the border drawn around the mini windows. Heads up, this one also changes the minimum size of the mini windows, which ends up being 2 * WindowBorderWidth + WindowMinSize. Default is 1.
  • *FvwmPager: Window3DBorders — gives the mini windows 3D borders based on the mini window background. ⚠️ This one only works when windows are configured using colorsets — check WindowColorset and FocusColorset over in DESK STYLES below.
  • *FvwmPager: MiniIcons — lets the pager show a window's mini icon in the pager (if it has one) instead of the window's label. Little note tho: when you're setting custom MiniIcons in fvwm, you might need to add the 'EWMHMiniIconOverride' style for apps that supply their own icon.
  • *FvwmPager: WindowMinSize n — the minimum size of mini windows, in n pixels. This does not count the border width, so the actual minimum size is 2 * WindowBorderWidth + WindowMinSize. Default is 3.
  • *FvwmPager: HideSmallWindows — tells FvwmPager to just not show windows that are at the minimum size. Perfect for tiny pagers where little windows look out of place. 🙈

🎈 BALLOON WINDOWS 🎈

Balloon windows = popup labels for each window when your mouse hovers over it. Label, font, color, and position are all configurable down here. 🫶

  • *FvwmPager: Balloons type — shows a balloon describing the window when the pointer moves into a window in the pager. The default format (the window's icon name) can be changed with BalloonStringFormat. Here's the tea on type:
    • "Pager" → balloons only show for an un-iconified pager.
    • "Icon" → balloons only show for an iconified pager.
    • "All" (or literally any unused non-blank value) → balloons always show.
    • "None" → balloons never show. That's the default behavior. 💀
  • *FvwmPager: BalloonFont font-name — the font for the balloon text. Defaults to fixed.
  • *FvwmPager: BalloonStringFormat format — same energy as WindowLabelFormat: this is the string that shows up in the balloons. Flags are %t, %i, %c, and %r — window's title, icon title, class, or resource name. Default is "%i".
  • *FvwmPager: BalloonBorderWidth number — the width of the balloon window's border. Defaults to 1.
  • *FvwmPager: BalloonYOffset number — the balloon window gets positioned horizontally centered against the pager window it's describing, and this sets the vertical position as an offset. Negative offsets like -n go n pixels above the pager window; positive offsets like +n go n pixels below. Offsets of -1 and 1 put the balloon window close to the original window with no gap. ⚠️ Offsets of 0 are not permitted, because that would let you travel directly from the pager window to the balloon window and cause an event loop. Defaults to +3. And the offset will flip sign all by itself whenever it needs to, so the balloon stays on screen. 🧚

🖱️ MOUSE BEHAVIOUR 🖱️

You can use the mouse to change the current virtual desk/page, scroll through pages, move windows, all of it. Each mouse button <N> can have a single action bound to it. Only the primary mouse buttons, 1 - 5, are supported. The default bindings are, no cap, literally this:

*FvwmPager: Mouse 1 ChangePage
*FvwmPager: Mouse 2 MoveWindow FlipFocus NoWarp
*FvwmPager: Mouse 3 Scroll
*FvwmPager: Mouse 4 Nop
*FvwmPager: Mouse 5 Nop

And you can customize all of it with these:

  • *FvwmPager: Mouse <N> ChangePage — changes the virtual page and/or desktop currently visible, based on where you clicked. The exact behavior depends on which DesktopConfiguration you're using and what mode the pager is in. Generally the pager will only change desk/page if it's absolutely clear which monitor to move. Per DesktopConfiguration:
    • global: clicks on labels or pages move all monitors to the desktop and/or page you clicked.
    • per-monitor: clicks on monitor labels move that monitor to the corresponding desktop. Clicks on desk labels do nothing. Clicks on a page move the monitor corresponding to the area you clicked to that page.
    • shared: the only way to move monitors between desktops is clicking on the monitor labels. Clicks on pages move the current monitor (if there is one) on that desktop to the corresponding page.
  • *FvwmPager: Mouse <N> MoveWindow [command] — move a window by clicking and dragging it somewhere new. If you drag it out of the pager, the window moves to the pointer and you can keep moving it on the current monitor. How far you gotta move it before it registers is set by the MoveThreshold option, default 3 pixels. Windows moved less than the MoveThreshold get the optional fvwm command (if you set one) sent to them — default is "FlipFocus NoWarp". Setting the SendCmdAfterMove option will also send the command after the window lands in its new spot. Note: by default the EWMH working area is honored, and window placement gets adjusted to fit inside the working area of the monitor it lands on. Wanna turn that off? Use IgnoreWorkingArea. 🔥
  • *FvwmPager: Mouse <N> WindowCmd command — sends the fvwm command to the window you clicked. Great for focusing, maximizing, iconifying windows straight from the pager.
  • *FvwmPager: Mouse <N> Scroll — clicking on a page centers the view port at that point using the fvwm Scroll command. Hold the button down and drag and the view port Scroll follows your mouse. This works best with global DesktopConfiguration.
  • *FvwmPager: Mouse <N> Cmd command — clicking anywhere on the pager sends the command to fvwm. Use case? Making the mouse wheel change virtual desktops on a pager that's only viewing the active desktop. Chef's kiss. 👑
  • *FvwmPager: Mouse <N> Nop — does absolutely nothing. Lowkey useful for disabling the default bindings.
  • *FvwmPager: MoveThreshold pixels — the distance the pointer has to move before a window being dragged with button 2 actually moves. Default is three pixels. If the pointer moves less than this, the window snaps back to its original position when you let go. If pixels is less than zero, the default value is used. The value set with the MoveThreshold command in fvwm is inherited by FvwmPager, but you can override it with this option.
  • *FvwmPager: SloppyFocus — with this on, you don't need to click into the mini window in the pager to give the real window focus. Just floating the pointer over the window inside the pager is enough. ✨
Okay so real talk, this option interferes slightly with the MouseFocus and SloppyFocus styles of fvwm. Sometimes if you click into the pager window to change pages or desks and then move the pointer somewhere on screen where a window of the new page is about to appear, that new window doesn't get the input focus. This can happen if you drag the pointer over one of the mini windows in the pager. There is nothing that can be done about it — except not using SloppyFocus in the pager. Sorry bestie 😭
  • *FvwmPager: SendCmdAfterMove — after moving a window with the pager, send the configured command — "FlipFocus NoWarp" by default — to the window. Normally the command is only sent on a click, not on a move.
  • *FvwmPager: IgnoreWorkingArea — after moving a window, ignore the working area when placing it. So the window's position no longer gets adjusted to fit inside the working area of the monitor it's placed in.

🖥️ MONITOR AND DESKTOP CONFIGURATION 🖥️

FvwmPager supports multiple monitors plus the per-monitor and shared DesktopConfiguration. You can also configure it to show only a single monitor, or to interact with monitors in specific ways. Very main character of it.

  • *FvwmPager: Monitor RandRName — tells FvwmPager to display windows only on the RandRName monitor. This is especially meaningful when the DesktopConfiguration command is set to shared. If RandRName is none, the monitor is unset and the pager will show windows on all monitors.
  • *FvwmPager: CurrentMonitor RandRName — when you're viewing only the current desktop (either via the icon pager or by running FvwmPager *), the current desktop gets updated every single time any monitor changes desktops. That might not be what you want if you're in per-monitor or shared mode. This option sets the current monitor to RandRName, and then the current desk is only updated when that monitor changes desks — changes from any other monitor get ignored. If RandRName is none, the current_monitor is unset and everything reverts to the default behavior. 💜
  • *FvwmPager: CurrentDeskPerMonitor — okay so when you're looking at just the current desktop (either with the icon pager or by running FvwmPager *), this makes the pager show the windows on the desktop each monitor is looking at, all independent of each other 💅. Example time: monitor 0's chunk of the pager shows its windows on desktop 2, while monitor 1's chunk shows its windows on desktop 1 — the desktop it's vibing on right now. When you use this with DeskLabels, you get one desk label per monitor saying which desk that monitor is on, and you should use MonitorLabels to get the monitor names tied to each desk 🫶
  • *FvwmPager: CurrentDeskGlobal — this one cancels CurrentDeskPerMonitor and puts you right back to the default. no cap ✨
  • *FvwmPager: IsShared — setting this tells fvwm to use shared mode, which is designed to work its absolute best with DesktopConfiguration shared 🦋. In this mode, each desktop shows only the windows and area taken up by the last monitor that viewed that desktop. Pair it with MonitorLabels so you can change each monitor's desktop by clicking on its label. iykyk 💖
  • *FvwmPager: IsNotShared — this turns off that previous IsShared setting. simple as 🌸

🎀 DESK STYLES 🎀

These config options let you style up each desk the pager shows, one at a time, like the icon you are 👑. They all take one or two parameters: the first is optional and it's the desk you want to configure, the second is the value you're setting it to. If you skip the desk, or you just use a *, the setting lands on all desktops.

Colorsets are preferred over color names, fr fr. Once a colorset is set up, the related color settings have no effect anymore — they're done, they're over 💀. When you use colorsets, the pager updates if the colorset changes in fvwm. Color names are still supported though, and any valid X11/rgb.txt name is accepted. For best results? Don't mix colorsets and color names, bestie, pick a lane 💅.

Note bestie: setting an option for all desks will override any previous options you set. So set your global all-desks options first, and your individual single-desk options second. no cap.

Example time — to make all desks use colorsets 10 and 11, except desk 2 which uses colorsets 12 and 13:

*FvwmPager: Colorset 10
*FvwmPager: HilightColorset 11
*FvwmPager: Colorset 2 12
*FvwmPager: HilightColorset 2 13

🌈 COLORSETS 🌈

  • *FvwmPager: Colorset [desk] colorset — sets the colorset number each desktop uses. This colorset is what the foreground text in the DeskLabels and MonitorLabels uses, plus the background color for each desktop 🎨. It can also set a pixmap for the background, or be transparent. Heads up: this colorset overrides and sets both Fore and Back below.
  • *FvwmPager: HilightColorset [desk] colorset — sets the colorset for the highlighted monitor location and labels ✨. The foreground color is for the text in highlighted labels, and the background sets the color of both the labels and the active monitor locations. You can also use pixmaps or transparency for the background instead. This colorset overrides and sets both HiFore and HiBack below.
  • *FvwmPager: WindowColorset [desk] colorset — sets the colorset your mini windows use 🪟. The foreground is used for the border and text labels, while the background color is used for the window itself. If Windows3DBorders is specified, the hilight and shadow colors from the colorset get used for the 3D beveled borders. Pixmaps and transparent colorsets? Also supported. obsessed 💖
  • *FvwmPager: FocusColorset [desk] colorset — sets the colorset for the focused mini window. Same as WindowColorset, except it applies to the focus window. slay 💅
  • *FvwmPager: WindowColorsets WindowColorset FocusColorset — this one's for backwards compatibility, and it sets both the window WindowColorset and the FocusColorset for all desktops. If you want per-desktop colorsets, use the individual commands above, bestie 🫶
  • *FvwmPager: BalloonColorset [desk] colorset — sets the colorset used for the foreground, background, and borders of the balloon window 🎈

💜 COLORS 💜

  • *FvwmPager: Fore [desk] color — sets the foreground color, which writes the desktop labels and draws the page-grid lines ✍️
  • *FvwmPager: Back [desk] color — sets the background color, used for the background of each desk 🖼️

For backwards compatibility, the option *FvwmPager: DeskColor [desk] color is an alias for this option and works the exact same.

  • *FvwmPager: HiFore [desk] color — sets the foreground color for the text used in the highlighted DeskLabels and MonitorLabels if DeskHilight is set ✨
  • *FvwmPager: HiBack [desk] color — sets the background color for the highlighted labels when using DeskLabels or MonitorLabels, and sets the color used for the location of any active monitors. Has no effect if DeskHilight is not set, so don't come crying to me 😭

For backwards compatibility, the option *FvwmPager: Hilight [desk] color is an alias for this option and works the exact same.

  • *FvwmPager: WindowFore [desk] color — sets the foreground color for the mini windows. This is the color of the borders and any text labels in the windows 💅
  • *FvwmPager: WindowBack [desk] color — sets the background color for the mini windows 🪟
  • *FvwmPager: FocusFore [desk] color — same as WindowFore, except it sets the foreground color of the focused window 🌟
  • *FvwmPager: FocusBack [desk] color — same as WindowBack, except it sets the background color of the focused window 🌟
  • *FvwmPager: WindowColors WindowFore WindowBack FocusFore FocusBack — backwards compatibility option that sets all four colors — WindowFore, WindowBack, FocusFore, and FocusBack — in one single command, for all desktops. For per-desktop colors, use the individual commands 🎀
  • *FvwmPager: BalloonFore [desk] color — specifies the color for text in the balloon window 💬. If you omit it, it defaults to the foreground color for the window being described.
  • *FvwmPager: BalloonBack [desk] color — specifies the background color for the balloon window 🎈. If you omit it, it defaults to the background color for the window being described.
  • *FvwmPager: BalloonBorderColor [desk] color — sets the color of the balloon window's border. Defaults to black 🖤

🦋 PIXMAPS 🦋

  • *FvwmPager: Pixmap [desk] pixmap — sets the pixmap to be used as the background image instead of the Back color for the desktop desk 🖼️

For backwards compatibility, the option *FvwmPager: DeskPixmap [desk] pixmap is an alias for this option and works the exact same.

  • *FvwmPager: HilightPixmap [desk] pixmap — sets the pixmap to be used as the background image of the active monitor locations, instead of the Hilight color, for the desktop desk ✨
  • *FvwmPager: LabelPixmap [desk] True|False — by default, pixmaps are drawn in the root window for each desk, which covers up the labels 🙈. Turning this off with False, F, or 0 will draw pixmaps only over the virtual desktop window, making the labels way easier to see 👀. You can turn it back on with True, T, or 1. Note bestie: disabling this will not work with transparent colorsets 💀

🌸 MISCELLANEOUS 🌸

  • *FvwmPager: UseSkipList — tells FvwmPager to not show the windows that are using the WindowListSkip style 🙅
  • *FvwmPager: StartIconic — makes the pager start iconified 😴
  • *FvwmPager: NoStartIconic — makes the pager start normally. Useful for canceling out the effect of the StartIconic option ✨
  • *FvwmPager: SolidSeparators — by default the pages of the virtual desktop are separated by dashed lines in the pager window. This option makes FvwmPager use solid lines instead 📏
  • *FvwmPager: NoSeparators — turns off the lines separating the pages of the virtual desktop. gone, deleted, periodt 💅

💬 SENDING COMMANDS 💬

Using the SendToModule command, you can send FvwmPager this whole list of commands: Monitor, CurrentMonitor, DeskLabels, NoDeskLabels, MonitorLabels, NoMonitorLabels, CurrentDeskPerMonitor, CurrentDeskGlobal, IsShared, and IsNotShared. Each command does literally the exact same thing as its configuration option — it just changes the config of the running pager 🫶

Note: these commands work on the running instance only. To make any changes permanent, go update the relevant config file, bestie 📝

For example, you can tell a running instance of FvwmPager to track a specific monitor by sending it this command:

SendToModule FvwmPager Monitor RandRname

This will either change which monitor is being shown, or tell the pager to only show a specific monitor 👑. Note that the special value of none will show all windows on all monitors 🌈

👑 AUTHOR 👑

Robert Nation

DeskColor patch contributed by Alan Wild

MiniIcons & WindowColors patch contributed by Rob Whapham

Balloons patch by Ric Lister ric@giccs.georgetown.edu

fvwm-workers: Dominik, Olivier, Hippo and others.

and that's the whole page, bestie, we ate that up fr fr 💖✨ this one's from the FVWMPAGER(1) era, dated 2026-07-31 — thanks for reading my lil manual rant, mwah 🎀💅

📦 where this page comes from