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 $HOMEIf 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.