fvwm2 [[-blackout] \
[-clientId id] \
[-cmd config_command] \
[-d displayname] \
[-debug] \
[-debug_stack_ring] \
[-f config_file] \
[-h] \
[-replace] \
[-restore state_file] \
[-s] \
[-version] \
[-visual visual_class] \
[-visualId id]]
$HOME/.fvwm
$FVWM_USERDIR
$HOME
If this fails the file system.fvwm2rc is searched in the directory
where fvwm2 was installed (/usr/X11R6/lib/X11/fvwm2).
Lines starting with a '#' character are comments. Lines starting with a '*' character are module configuration lines. Lines ending with an escaped newline character ('\') have a continuation line.
The order for inserting configurations lines is:
1. Colors
2. Path setup (ModulePath, ImagePath)
3. Style settings, including the default style.
4. InitFunction, RestartFunction and ExitFunction definitions
5. Other Functions. Functions cannot be forward referenced from
other functions, but they can be backward referenced
6. Menus definitions. Same caveats about forward referencing
7. Key and Mouse Bindings
8. Module options
button: number (0 - 9), All, Left, Right
state: ActiveUp, ActiveDown, Inactive,
ToggledActiveUp, ToggledActiveDown, ToggledInactive,
empty string means all states
style: Simple, Default, Solid color
[Vector] count X0xY0@0 X1xY1@1
X,Y: pixel coordinates
@0: shadow color, @1: highlight color, @2: background color
e.g. X0xY0@0 X1xY1@1 draws a line from X0,Y0 to X1,Y1 in the highlight color
coordinate origin at left top corner, size in percent of height of TitleStyle
BGradient, CGradient, DGradient, HGradient
RGradient, SGradient, VGradient, YGradient
arguments: colorcount startcolor endcolor, or
colorcount segmentcount color incr% [color incr% ...] endcolor
Pixmap file
MiniIcon file
TiledPixmap file
flag: Raised, Sunk, Flat, UseTitleStyle, UseBorderStyle
MWMDecorMenue, MWMDecorMIn, MWMDecorMax
Left, Right, Bottom, Top for pixmaps
state: ActiveUp, ActiveDown, Inactive,
ToggledActiveUp, ToggledActiveDown, ToggledInactive,
empty string means all states
style: see TitleStyle and ButtonStyle
flag: Raised, Sunk, Flat
[+ AddButtonStyle ...] [+ AddTitleStyle ...] [+ BorderStyle ...] [+ ButtonStyle ...] [+ TitleStyle ...]
+ trigger action
trigger: Click or C
DoubleClick or D
Hold or H
Immediate or I
Move or M
action: command parameters
parameters: $c: class
$r: resource name
$n: current window name
$w: window id
$d: current desk number
$v: fvwm version
$x: x-coordinate of current viewport
$y: y-coordinate of current viewport
$0...$9: arguments
$.: abs dir of current read file
$*: all positional parameters
$[desk.width] width og whole desktop
$[desk.height] height of whole desktop
$[vp.x]: x-coordinate of current viewport
$[vp.y]: y-coordinate of current viewport
$[vp.width]: width of current viewport
$[vp.height]: height of current viewport
$[w.x]: x-coordinate of current window
$[w.y]: x-coordinate of current window
$[w.width]: width of current window
$[w.height]: width of current window
$[screen]: screen number
$[env-var]: environment variable
$[page.nx]: current page number X
$[page.ny]: current page number Y
$[fg.cs<n>]: forground colorset
$[bg.cs<n>]: background colorset
$[hilight.cs<n>]: hilight colorset
$[shadow.cs<n>]: shadow clorset
+ [menu-&label][*xpm-file*][%xpm-file%] command
[+ MissingSubmenuFunc command]
[+ DynamicPopupAction command]
[+ DynamicPopdownAction command]
menu-name: @xpm-file@: picture left to text
^color^: color of picture
menu-label: &: underline and hotkey
"" Nop: separator
*xpm-file*: picture above text
%xpm-file%: picture left to text
conditions: CurrentDesk
CurrentPage
CurrentPageAnyDesk
Iconic, !Iconic
Layer [n]
Maximized, !Maximized
PlacedByButton3, !PlacedByButton3
Raised, !Raised
Shaded, !Shaded
Sticky, !Sticky
Transient, !Transient
Visible, !Visible
WindowName, wildcards allowed
x, y: percent of screen width (height) or pixel if p w: relative to current window m: relative to current pointer (mouse) Warp: warps cursor
state: Active, Inactive,
empty string means all states
style: TiledPixmap, Simple
flag: HiddenHandles, NoInset, Flat, Sunk, Raised
default: HiddenHandles disabled
option: FlickeringMoveWorkaround
MixedVisualWorkaround
ModalityIsEvil
QtDialogsWorkaround
RaiseOverNativeWindows
RaiseOverUnmanaged
bool: true = activate option, false = deactivate option,
not given or toggle = toggle option
option: DynamicMenu
ModulSynchronous
Read
Wait
*
bool: true = use cursor, false = don't use cursor
bool: true = use state, false = don't use state
button: number (0 - 9), all, Left, Right, Reset
state: ActiveUp, ActiveDown, Inactive,
ToggledActiveUp, ToggledActiveDown, ToggledInactive,
empty string means all states
style: Simple, Default, Solid color
[Vector] count X0xY0@0 X1xY1@1
X,Y: pixel coordinates
@0: shadow color, @1: highlight color, @2: background color
e.g. X0xY0@0 X1xY1@1 draws a line from X0,Y0 to X1,Y1 in the highlight color
coordinate origin at left top corner, size percent of height of TitleStyle
BGradient, CGradient, DGradient, HGradient
RGradient, SGradient, VGradient, YGradient
arguments: colorcount startcolor endcolor, or
colorcount segmentcount color incr% [color incr% ...] endcolor
Pixmap file
MiniIcon file
TiledPixmap file
Default [n]
flag: Raised, Sunk, Flat, UseTitleStyle, UseBorderStyle
Left, Right, Top, Bottom, (default = centered) for pixmaps
MWMDecorStick, MWMDecorShade
button: number (0 - 9), all, Left, Right
flag: Raised, Sunk, Flat, UseTitleStyle, UseBorderStyle
MWMDecorMenue, MWMDecorMIn, MWMDecorMax, MWMDecorStick, MWMDecorShade
Clear to clear flags
name: name of decor, or Default
default: 150 ms
limit: 0..60, 0 = no limit, default
conditions: see All
horizontal, vertical: in percent of page, or p for pixel
context: BOTTOM (bottom_side)
BOTTOM_EDGE (bottom_side)
BOTTOM_LEFT (bottom_left_corner)
BOTTOM_RIGHT (bottom_right_corner)
DEFAULT (top_left_arrow)
DESTROY (pirate)
LEFT (left_side)
LEFT_EDGE (left_side)
MENU (top_left_arrow)
MOVE (fleur)
POSITION (top_left_corner)
RESIZE (sizing)
RIGHT (right_side)
RIGHT_EDGE (right_side)
ROOT (left_ptr)
SELECT (crosshair)
STROKE (plus)
SYS (hand2)
TITLE (top_left_arrow)
TOP (top_side)
TOP_EDGE (top_side)
TOP_LEFT (top_left_corner)
TOP_RIGHT (top_right_corner)
WAIT (watch)
number: as defined in cursorfont.h
name : as defined in cursorfont.h
xpm-file: name of a cursor file in xpm format
None: no cursor
Tiny: single pixel cursor
horizontal, vertical: units of physical sreens
conditions: see All direction: North, Northeast, East, Southeast, South, Southwest, West, Northwest
scrolling: milliseconds before viewport move moving: pixels before moving window
horizontal, vertical: percent of page, or pixel if p
multiplied by 1000: wrap arround
0: no edge scrolling 1: smallest pan frame 2: default the values are pixel
use Exec exec command to avoid subshells (no ampersand in command)
shell: bash, tcsh, ..., sh is default
bool: true = iconify only, false = deiconify only
not given or toggle = toggle state
modifiers: see Mouse or Key
path: full path name of directory
keyname: see keysymdef.h context: see Mouse modifiers: see Mouse function: function name or - to remove binding
bool: true = maximize, false = minimize,
not given or toggle = toggle state
horizontal: percent of screen, or pixel if p, or Grow, GrowLeft, or GrowRight
vertical: percent of screen, or pixel if p, or Grow, GrowUp, or GrowDown
position: [[context-rectangle] [o<n> | c]x[m | p] [o<n> | c]y[m | p]] [special-options]
context-rectangle:
Button n: button #n of the focused window
Context: the current window, menu or icon
Icon: the focused icon
Interior: the inside of the focused window
Item: current menu item
Menu: the current menu
Mouse: a 1x1 rectangle at the mouse position.(default)
Rectangle: X-geometry-format
Root: the root window
This: whatever widget the pointer is on
Title: the title of the focused window or icon
Window: the window with the focus
special-options: Animated, Mwm, Win, Fixed, WarpTitle, NoWarp, SelectInPlace
x,y percent of context-rectangle
o: overlap percentage (o0 = default)
c: = o50
m: menu width (height)
p: pixel
stylename: * for the default menu
options: ActiveColorset [n]
ActiveFore color/ActiveForeOff
Animation/AnimationOff
AutomaticHotkeys/automaticHotkeysOff
Background color
BorderWidth width
DeletSubmenus/HoldSubmenus
DoubleClickTime milliseconds (default 450 ms)
Font name
Foreground color
FVWM/MWM/WIN
Greyed color
GreyedColorset [n]
Hilight3DThick/Hilight3DThin/Hilight3DOff
Hilight3DThickness -50 ... 50 pixels
HilightBack color/HilightBackOff
ItemFormat format
format: %l = left justified
%c = cetered
%r = right justified
%i = mini-icon
%> = submenu triangle right
%< = submenu triangle left
%| = start or end of hilighted area
%s = side picture,
<Space>, <Tab> = a space
%<Space%gt;, <%Tab> = eight spaces
%p = empty area
MenuColorset [n]
MenuFace style, see ButtonStyle
PopdownDelay milliseconds
PopdownImmediately/PopdownDelayed
PopupAsRootMenu/PopupAsSubmenu
PopupDelay milliseconds
PopupImmediately/PopupDelayed
PopupOffset x y percent of parent menu
RemoveSubmenus/HoldSubmenus
SelectOnRelease [key]
SeparatorsLong/SeparatorsShort
SideColor color
SidePic file
SubmenusRight/SubmenusLeft
TitleUnderlines0/TitleUnderlines1/TitleUnderlines2
TitleWarp/TitleWarpOff
TrianglesSolid/TrianglesRelief
VerticalItemSpacing y x
VerticalTitleSpacing y x
modul-name: FvwmAnimate (fancy animation of (de)iconification)
FvwmAudio (makes sounds to go with window manager actions)
FvwmAuto (an auto raise module)
FvwmBacker (to change the background when you change desktops)
FvwmBanner (to display a spiffy XPM)
FvwmButtons (brings up a customizable tool bar)
FvwmCommandS (a command server to use with shell's FvwmCommand client)
FvwmCpp (to preprocess your .fvwm2rc with cpp)
FvwmDebug (to debug your configuration)
FvwmDragWell (the place to drag&drop to)
FvwmEvent (trigger various actions by events)
FvwmForm (to bring up dialogs)
FvwmGtk (to bring up GTK menus and dialogs)
FvwmIconBox (like the mwm Icon-Box)
FvwmIconMan (like the twm icon manager)
FvwmIdent (to get window info)
FvwmM4 (to preprocess your .fvwm2rc with m4)
FvwmPager (a mini version of the desktop)
FvwmRearange (to rearange windows)
FvwmSave (saves the desktop state in .xinitrc style)
FvwmSaveDesk (saves the desktop state in fvwm commands)
FvwmScript (another powerful dialog toolkit)
FvwmScroll (puts scrollbars on any window)
FvwmTalk (to interactively run fvwm commands)
FvwmTaskBar (a Windows like taskbar)
FvwmTheme (manages colorsets)
FvwmWarf (AfterStep like button bar)
FvwmWinList (a window list)
Note: there may be other modules around
path: full path name to directory
button: 1, 2, 3, or 0 for any
context: any combination of
A: any, except title bar buttons
F: window frame (the corner)
I: Icon
R: root window
S: window sides
T: title bar
W: application window
0-9: title bar button number
title bar buttons: 1 3 5 7 9 0 8 6 4 2
modifiers: any combination of
A: any
C: Control
H: Hold
L: Caps-Lock
M: Meta (Alt)
N: none
S: Shift
0..5: X11 MOD1..MOD5
function: command or - to remove binding
see AnimatedMove
see GotoDesk
x,y: page p: move relative to current page
conditions: see All plus
CirculateHit
CirculateHitIcon
conditions: see All
default 5
conditions: see All
position: see Menu
conditions: see All
AddToFunc raise-to-top + I Layer 0 ontop + I Raise
width, height: in percent of page, or p for pixel, or c for client supplied unit x, y: coordinates of bottoright corner
horizontal, vertical: percent of page, or pixel if p
multiplied by 1000: wrap arround
fractions-to-move-list: list of numbers between 0 and 1 default: 10 -.01 0 .01 .03 .08 .18 .3 .45 .6 .75 .85 .90 .94 .97 .99 1.0
proximity: -1(default): no snapping, else number of pixels behavior: All, SameType, Windows, Icons, All is default
x-grid-size, y-grid-size: in pixel, 1(default) = no grid
bool: true = stick, false = unstick,
not given or toggle = toggle state
options: NotStayPressed
EchoSequence
DrawMotion
Feedback
StrokeWidth width
windowname: name, class, or resource string of an window, (wildcards are allowed)
options: BackColor color
BackingStore/BackingStoreOff
BorderColorset [n]
BorderWidth pixel
CaptureHonorsStartsOnPage/CaptureIgnorsStartsOnPage
CascadePlacement/TileCascadePlacement/TileManualPlacement/
MinOverlapPlacement/MinOverlapPlacementPercent/ManualPlacement
CirculateSkip/CirculateHit
CirculateSkipShade/CirculateSkipShadeOff
ClickToFocus/MouseFocus | FocusFollowsMouse/SloppyFocus/NeverFocus
ClickToFocusPassesClickOff/ClickToFocusPassesClick
ClickToFocusRaisesOff/ClickToFocusRaises
Color textcolor/bordercolor
Colorset [n]
DecorateTransient/NakedTransient
DepressableBorder/FirmBorder
FixedPosition/VariablePosition
Font font
ForeColor color
GNOMEIgnoreHints/GNOMEUseHints
GrabFocusOff/GrabFocusOff
GrabFocusTransientOff/GrabFocusTransient
HandleWidth pixel
HilightBack color
HilightBorderColorset [n]
HilightColorset [n]
HilightFore color
HintOverride/NoOverride
IconBox left, top, right, bottom, None, or geometry
IconFill dir1 dir2
dir1, dir2: t(op), b(ottom), l(eft), r(ight)
default: left to right then top to bottom (e.g. l b)
IconFont font
IconGrid x y pixel (3x3 = default)
IconifyWindowGroups/IconifyWindowGroupsOff
IconOverride/NoIconOverride/NoActiveIconOverride
IconTitle/NoIconTitle
IgnoreRestack/AllowRestack
KeepWindowGroupsOnDesk/ScatterWindowGroups
Layer n
Lenience/NoLenience
LowerTransient/DontLowerTransient
ManualPlacementHonorsStartsOnPage/ManualPlacementIgnoresStartsOnPage
MiniIcon file
MouseFocusClickRaises/MouseFocusClickRaisesOff
MWMBorder/FvwmBorder
MWMButtons/FvwmButtons
MWMDecor/NoDecorHint
MWMFunctions/NoFuncHint
NoButton n/Button n
NoHandles/Handles
NoIcon/Icon [file]
NoIconPosition/UseIconPosition
NoPPosition/UsePPosition
NoTitle/Title
OLDecor/NoOLDecor
ParentalRelativity/Opacity
RaiseTransient/DontRaiseTransient
RecaptureHonorsStartsOnPage/RecaptureIgnoresStartsOnPage
ResizeHintOverrideMaxWindowSize [width[p] height[p]]
ResizeOpaque/ResizeOutline
SaveUnder/SaveUnderOff
SkipMapping/ShowMapping
StackTransientParent/DontStackTransientParent
StartIconic/StartNormal
StartsLowered/StartsRaised
StartsOnDesk n/StartsOnPage [desk] [x y]/StartsAnywhere
StartsOnPageIncludesTransients/StartsOnPageIgnoresTransients
StaysOnTop/StaysPut/StaysOnBottom
Sticky/Slippery
StickyIcon/SlipperyIcon
StippledTitle/StippledTitleOff
TitleAtBottom/TitleAtTop
UseDecor name (default not specified)
UseStyle name
WindowListSkip/WindowListHit
WindowShadeShrinks/WinowShadeScrolls
WindowshadeSteps n
justification: Centered, RightJustified, LeftJustified, Default: Centered Height: pixels, must be set after the font
state: ActiveUp, ActiveDown, Inactive,
ToggledActiveUp, ToggledActiveDown, ToggledInactive,
empty string means all states
style: Simple, Default, Solid color
BGradient, CGradient, DGradient, HGradient
RGradient, SGradient, VGradient, YGradient
arguments: colorcount startcolor endcolor, or
colorcount segmentcount color incr% [color incr% ...] endcolor
Pixmap file
MiniIcon file
TiledPixmap file
flag: Raised, Sunk, Flat
x, y: percent of page, or pixel if p
conditions: see All
position: see Menu
options: Alphabetic/NotAlphbetic
CurrentDesk
Desk desknum
Function funcname args
Layer m [n]
NoDeskSort
NoGeometry/Geometry
NoGeometryWithInfo
NoHotkeys
NoIcons/Icons/OnlyIcons
NoNormal/Normal/OnlyNormal
NoOnBottom/OnBottom/OnlyOnBottom
NoOnTop/OnTop/OnlyOnTop
NoSticky/Sticky/OnlySticky
SelectOnRelease
UseIconName
UseListSkip/OnlyListSkip
action: see Menu
default: AddToFunc WindowListFunc
+ I WindowId $0 Iconify -1
+ I WindowId $0 FlipFocus
+ I WindowId $0 Raise
+ I WindowId $0 WarpToWindow 5p 5p
bool: true = force shade, false = force normal,
not given or toggle: toggle state
DISPLAY, FVWM_MODULEDIR, FVWM_USERDIR, SESSION_MANAGER, SESSION_MANAGER_NAME SM_SAVE_DIR
Key Help R A Popup MenuFvwmRoot Key F1 R A Popup MenuFvwmRoot Key Tab A M WindowList Root c c NoDeskSort Key Escape A MC EscapeFunc Mouse 1 TS A FuncFvwmRaiseLowerX Move Mouse 1 F A FuncFvwmRaiseLowerX Resize AddToFunc FuncFvwmRaiseLowerX I Raise + M $0 + D Lower
Please use X11 colornames or the rgb:rrrr/gggg/bbbb (hex) notation
yes, on, true, t, y means true no, off, false, f, n means false toggle means toggle state
HGradient is horizontal, VGradient is vertical, DGradient is diagonal from top left to bottom right, BGradient is backwards diagonal from bottom left to top right, SGradient is concentric squares, CGradient is concentric circles, RGradient is a radar like pattern and YGradient is a Yin Yang style (but without the dots). The gradient styles H, V, B and D are optimized for high speed and low memory consumption in menus.
Popup Window-Opsbut if you replace the dash with a space, then you need quotes:
Popup "Window Ops"
The supported quoting characters are double quotes, single quotes and reverse single quotes. All three kinds of quotes are treated in the same way. Single characters can be quoted with a preceding backslash. Quoting single characters works even inside other kinds of quotes.