FVWM-CONVERT-2.6(1)

💖 NAME 💖

fvwm-convert-2.6 — bestie, it takes your old fvwm 2.4.x config file and turns it into fvwm 2.6 style. glow up era fr.

---

✨ SYNOPSIS ✨

fvwm-convert-2.6 [--follow-read|-f] [--help|-h] source

---

🎀 OPTIONS 🎀

• --help, -h — prints a usage message onto your screen. like, it tells you how to use it. iconic behaviour tbh.
• --follow-read, -f — follows files it finds along with the Read command. it chases them down. yes queen.

---

🦋 DESCRIPTION 🦋

okay so here's the tea 👑: fvwm-convert-2.6 takes an fvwm 2.4.x configuration file and converts it into an fvwm 2.6 file with compatible syntax. it's giving translator, it's giving interpreter.

⚠️ NOT suitable for converting older 2.x configuration files!! please use fvwm-convert-2.2 to convert those to the 2.2.x format first, and then if necessary fvwm-convert-2.4. do it in order, bestie, don't skip steps 💅

By default, fvwm-convert-2.6 won't go looking for a given config file. nope. you have to specify it as the first parameter to fvwm-convert-2.6. different source and destination files may be given. if the destination file already exists, this program exits — no overwriting, no drama, just gone 🙈. if no destination file is given, then the filename is the same name as the source file with the suffix .converted added. and without an absolute path given as the destination path to the destination file, the program will create the destination file in the CWD (current working directory, iykyk).

Here's everything fvwm-convert-2.6 changes, no cap:

🌈 Style lines

In fvwm 2.4, most style options could be negated from their counterparts using NoFoo — fvwm-convert-2.6 corrects this by now using !Foo. glow up.

🌈 ModulePath

In fvwm 2.4 and beyond, the ModulePath is compiled into fvwm. fvwm-convert-2.6 comments out any ModulePath commands it finds. if you are using your own modules, (not the ones that come with fvwm), you will have to fix your configuration file after using fvwm-convert-2.6. bestie that's on you, sorry 😭

🌈 Conditional command syntax

In fvwm 2.4, the conditional command options were whitespace-separated — they should now be comma-separated instead. periodt. in addition, the older syntax to Next and Prev of using [*] to denote all windows has been removed entirely. gone. no more. both these checks and conversions are done on function commands, key/mouse bindings.

🌈 WindowShadeSteps

In fvwm 2.4, the WindowShadeSteps command is replaced by the WindowShadeSteps Style option. fvwm-convert-2.6 makes this change. it's a command-to-option pipeline transfer, slay.

🌈 FvwmTheme

In fvwm 2.6, the FvwmTheme module is replaced by a series of Colorset commands. whilst fvwm-convert-2.6 will try and make this change, it is still recommended that this is checked after conversion 👀 (see the BUGS section, it's relevant).

🌈 EdgeResistance

In fvwm 2.6, the EdgeResistance command is has been split to include an additional style option for EdgeMoveResistance. fvwm-convert-2.6 makes any changes necessary. one command became two, it's giving twins.

🌈 StartFunction / RestartFunction / InitFunction

In fvwm 2.6, the need for using InitFunction and/or RestartFunction is redundant when StartFunction is read at both of these times. fvwm-convert-2.6 attempts to convert this. attempts being the key word, bestie 🫶

🌈 Read

If -f or --follow-read is given, any files fvwm-convert-2.6 can detect and open will be converted automatically, else a list of files that can be followed are printed to the screen. so either it does it for you, or it hands you the list. your call 💖

---

💀 BUGS 💀

• InitFunction and RestartFunction and hence StartFunction are printed at the end of the files — this slight reordering might put some comments before in an odd spot. lowkey awkward, we know 😭
• When converting over FvwmTheme lines, the colorset definitions might well be broken, but these cannot easily be converted. yeah. that one hurts. check it manually fr fr.
• Bug reports can be sent to the fvwm-workers mailing list (see the FAQ). we want to hear from you bestie 🫶

---

👑 AUTHOR 👑

Thomas Adam thomas@fvwm.org

---

that's the whole page, babes 💜 this was FVWM-CONVERT-2.6(1), and the version we're living in was dated 2026-07-31. go convert something and slay ✨💅🌸