|*FvwmProxy: Colorset n||
Specifies the color theme for unselected proxy windows.
|*FvwmProxy: SelectColorset n||
Specifies the color theme for the selected proxy window.
|*FvwmProxy: IconifiedColorset n||
Specifies the color theme for proxy windows of iconified windows.
This is only meaningful in conjuction with the ProxyIconified option on.
|*FvwmProxy: Font font||
Specifies the font used for all proxy window text.
|*FvwmProxy: Width w||
Specifies the size in X of each proxy window.
|*FvwmProxy: Height h||
Specifies the size in Y of each proxy window.
|*FvwmProxy: Separation d||
Specifies the minimum distance between proxy windows when adjusting
|*FvwmProxy: ShowMiniIcons bool||
If true, proxy windows show the mini icon for the window they represent,
if it has a mini icon. The default is true.
|*FvwmProxy: EnterSelect bool||
If true, a proxy is automatically selected when the mouse is moved
over the proxy, even if no mouse buttons are pressed.
The default is false.
|*FvwmProxy: ProxyMove bool||
If true, moving a proxy window will move the window it represents.
Currently, the proxied window doesnt recognize snap effects during
|*FvwmProxy: ProxyIconified bool||
If true, continue to proxy windows when they are iconified.
In addition, consider adding click actions that Iconify on and off,
such as on the middlemouse button.
|*FvwmProxy: Action mouseaction response||
Tells FvwmProxy to do the specified response when the given
action is done.
The currently supported mouse actions are: Click1, Click2, Click3 and so on,
representing mouse clicks with various buttons.
By default, the module supports 3 mouse buttons, but it can be
compiled to support more.
The default responses are Raise, Nop, and Lower for Click1, Click2, and Click3,
|*FvwmProxy: Action Select command||
This selects an fvwm function to be called during a FvwmProxy Hide command
for the window whose proxy was selected.
The default is WindowListFunc. WindowListFunc is predefined by the
fvwm install. You can replace it, add to it,
or supply an independent function.
|*FvwmProxy: Action Show command||
This selects an fvwm function to be called during a FvwmProxy Show command.
The default is Nop.
|*FvwmProxy: Action Hide command||
This selects an fvwm function to be called during a FvwmProxy Hide command.
The default is Nop.
|*FvwmProxy: Action Abort command||
This selects an fvwm function to be called during a FvwmProxy Abort command.
The default is Nop.
|*FvwmProxy: Action Mark command||
This selects an fvwm function to be called on a window after it is marked.
The default is Nop.
|*FvwmProxy: Action Unmark command||
This selects an fvwm function to be called on a marked window just after
another window gets the mark.
The default is Nop.
|*FvwmProxy: Action ModifierRelease modifiers command||
This selects an fvwm function to be called while proxies are shown and
the specified modifiers are all released. The modifiers are specified
using the same syntax as in the Mouse command.
The default is Nop.
|*FvwmProxy: Group groupname command pattern||
For the given named group, adjust inclusion of the windows matching
The groupname is a string identifier used to associate windows.
The window pattern uses the same format as the Style command.
The supported commands are Include, SoftInclude, and Exclude.
Include and SoftInclude identifies a pattern to add windows
to the group.
Exclude identifies pattern to counteract inclusion pattern
or auto-inclusion (see flags below).
All exclusion checks follow all inclusion checks.
Soft inclusion limits the windows in that pattern to only move
when an non-soft window in the group moves.
Moving or resizing these windows does not affect any other windows.
They are also immune to edge effects.
For the given named group, activate the given flag.
The supported flags are AutoInclude, AutoSoft, and IgnoreIDs.
All window grouping is normally checked to only group windows
that are in the same process or that have the same X11 client leader.
IgnoreIDs deactivates this mechanism.
AutoInclude automatically includes any window that matches
the same process or client leader, without having to name them specifically.
AutoSoft makes all AutoInclusions soft (see inclusion description above).
|*FvwmProxy: SlotWidth w||
This specifies the width of the icons used in slots.
The default is 16.
|*FvwmProxy: SlotHeight h||
This specifies the height of the icons used in slots.
The default is 16.
|*FvwmProxy: SlotSpace d||
This specifies the space between icons used in slots.
The default is 4.
|*FvwmProxy: GroupSlot n||
This specifies the first slot that represent a colored group.
Group slots dont need icons as the are drawn by predetermined means.
The default is 2.
|*FvwmProxy: GroupCount n||
This specifies the number of group slots.
The default is 6.
|*FvwmProxy: SlotStyle n style||
For non-group slots, this defines the appears of the indicated slot.
The style format matches ButtonStyle command.
The default is nothing.
|*FvwmProxy: SlotAction n mouseaction response||
For non-group slots, this defines the behavior of the indicated slot.
The mouse action and response is used the same as the FvwmProxy
The default is Noop.
|*FvwmProxy: UndoLimit n||
This specifies the number of entires in the undo buffer.
this limits how far back you can undo.
The default is 8.
SendToModule FvwmProxy Show Activate proxy windows for all windows on the current desk that do not use the WindowListSkip option. If the desk is switched, new proxies are automatically generated.
SendToModule FvwmProxy Hide Deactivate all proxy windows. If a proxy is selected (such as with the Next and Prev commands), the Select Action is call on the window that the proxy represents. The default action includes raising the window and warping the mouse to a position over that window.
SendToModule FvwmProxy ShowToggle If shown, hide. If hidden, show.
SendToModule FvwmProxy Abort Deactivate all proxy windows. This differs from the Hide command in that no action is taken on any selected window.
SendToModule FvwmProxy Circulate command Tell FvwmProxy to run a conditional command and mark the result. The imbedded command SendToModule FvwmProxy Mark is automatically appended after the optional condition, so supplying your own imbedded command will probably fail. An example argument to Circulate is ScanForWindow East South (CurrentPage). If the proxies arent already shown (such as with the Show command), any Circulate command will automatically show the proxies.
SendToModule FvwmProxy Next (obsolete) If a proxy window is selected, the next proxy is selected. Windows with the WindowListSkip option are ignored. The proxies are sorted left to right during the Show command. If no proxy is currently selected, but a proxy on this desk was selected on a recent show, that proxy is selected. If no proxy on this desk was recently selected, the leftmost proxy is used. This nearly duplicates the functionality of Circulate ScanForWindow East South (CurrentPage).
SendToModule FvwmProxy Prev (obsolete) If a proxy window is selected, the previous proxy is selected. The starting point is the same as with the Next command, except that the choice with no recent selection is the rightmost proxy. This nearly duplicates the functionality of Circulate ScanForWindow West North (CurrentPage).
SendToModule FvwmProxy SoftToggle Toggle the soft group inclusion setting for the selected window. This setting is the same that can be activated using the SoftInclude and AutoSoft commands inside the FvwmProxy Group configuration.
SendToModule FvwmProxy IsolateToggle Toggle the isolation setting for the selected windows group. Isolated groups only allow one member to not be iconified at a time. The members are also coerced to the same position and size, constrained by their size increment.
SendToModule FvwmProxy PrevIsolated If focused on a member of a isolating group, deiconify the member higher on list. If no member is higher, deiconify the last member.
SendToModule FvwmProxy NextIsolated If focused on a member of a isolating group, deiconify the member lower on list. If no member is higher, deiconify the first member.
SendToModule FvwmProxy Undo Attempt to undo the last window move and/or resize.
SendToModule FvwmProxy Redo Attempt to redo the most recent Undo. If another move or resize occurs since the previous undo, the redo buffer is cleared.
The following are excerpts from a .fvwm2rc file which describe FvwmProxy initialization commands:But Meta-Shift-Tab can be awkward, so Meta-Q may be a better alternative.
Key Tab A M SendToModule FvwmProxy Circulate \ ScanForWindow East South (CurrentPage) Key Tab A SM SendToModule FvwmProxy Circulate \ ScanForWindow West North (CurrentPage)
*FvwmProxy: Action ModifierRelease M SendToModule FvwmProxy Hide
Key Q A M SendToModule FvwmProxy Circulate \ ScanForWindow West North (CurrentPage)
You might consider adding !Sticky to the (CurrentPage) conditional if you use Sticky for low-interactivity programs, like load meters and music players.
To have the proxies immediately pop up when you hold the Alt key, addIf thats too intrusive, you can assign Alt-Esc to switch the proxies on and off by adding
Key Meta_L A N SendToModule FvwmProxy Show
Some platforms have problems where general Alt key combinations becoming otherwise dysfunctional after defining these mappings. If this happens, it might be difficult to take full advantage of this module.
Key Escape A M SendToModule FvwmProxy ShowToggle
To have the mouse jump to the center instead of the upper left corner, try addingor just make your own list function from scratch, for example
AddToFunc WindowListFunc + I WarpToWindow 50 50
DestroyFunc WindowListFunc AddToFunc WindowListFunc + I WindowId $[w.id] Raise + I WindowId $[w.id] WarpToWindow 50 50
Note that the default configuration does not activate any Next/Prev operations for Alt-Tab since that sequence is, by default, used by another module. Adding appropriate key mappings to your .fvwm2rc will switch this responsibility to FvwmProxy.
If you use ProxyIconified, you might consider adding Iconify actions.
AddToFunc WindowListFunc + I WindowId $[w.id] Iconify Off
AddToFunc Raise-and-Deiconify + I WindowId $[w.id] Raise + I WindowId $[w.id] Iconify Off
*FvwmProxy: Action Click1 Raise-and-Deiconify *FvwmProxy: Action Click2 Iconify
You can set up some basic slots fairly easily.In this example, WindowMenu is something you would have to define. If your proxy width is too small, some slots can get cut off.
*FvwmProxy: GroupSlot 2 *FvwmProxy: GroupCount 5
*FvwmProxy: SlotStyle 1 MiniIcon *FvwmProxy: SlotStyle 7 Pixmap "squeeze.xpm" *FvwmProxy: SlotStyle 8 Pixmap "mini-up.xpm" *FvwmProxy: SlotStyle 9 Pixmap "mini-bball.xpm" *FvwmProxy: SlotStyle 10 Pixmap "mini-cross.xpm"
*FvwmProxy: SlotAction 1 Click1 Popup WindowMenu *FvwmProxy: SlotAction 7 Click1 SendToModule FvwmProxy IsolateToggle *FvwmProxy: SlotAction 8 Click1 SendToModule FvwmProxy SoftToggle *FvwmProxy: SlotAction 9 Click1 Iconify *FvwmProxy: SlotAction 10 Click1 Delete
Undo and redo can be easily mapped to any keys.
Key Z A 3 SendToModule FvwmProxy Undo Key R A 3 SendToModule FvwmProxy Redo
You can rotate through an isolated group using any keys. For example, meta cursor-up and cursor-down could traverse the group.
Key Up A 3 SendToModule FvwmProxy PrevIsolated Key Down A 3 SendToModule FvwmProxy NextIsolated
A somewhat impractical example of a group definition using GIMP is as follows:
*FvwmProxy: Group "GIMP" Include "The GIMP" *FvwmProxy: Group "GIMP" Include "Module Manager" *FvwmProxy: Group "GIMP" SoftInclude "Unit Editor" *FvwmProxy: Group "GIMP" AutoInclude *FvwmProxy: Group "GIMP" AutoSoft *FvwmProxy: Group "GIMP" Exclude "Preferences"
This sets up a hard attachment between the windows "The GIMP" and "Module Manager". The "Unit Editor" is also in the group, but only responds to movement of one of the hard inclusions. Any window in the same process or with the same client leader is also associated, but they default to soft inclusion, except "Preferences" which is explicitly excluded. Note that in this case, the explicit soft inclusion of "Unit Editor" is redundant with the combination of AutoInclude and AutoSoft. However, if AutoSoft was not specified, the explicit SoftInclude would distinguish that pattern from the otherwise hard inclusion under just AutoInclude.
|FVWM||FVWMPROXY (1)||(not released yet) (2.5.20)|