Root Menu configuration file

wlmaker displays a root menu when right-clicking on an unoccupied area of the workspace, or when pressing the configured hotkey for the RootMenu action.

It uses a built-in onfiguration (see etc/root-menu.plist), but can be overriden by setting the --root_menu_file argument (see Commandline Reference for wlmaker).

The root menu file must define a Plist array. The first element of the array specifies the menu's title, and further elements will either define a menu item, or a command to include a further plist file, or to invoke a shell command to generate a plist menu output.

Example: A menu with two items

("Menu Title",
  ("Item 1", None),
  ("Item 2", None)
)

Example: A menu including another file

("Include", IncludePlistMenu, "tests/data/menu.plist")

Example: A menu invoking a shell command to generate the menu

("Include", GeneratePlistMenu, "cat tests/data/menu.plist")

wmmenugen

Window Maker provides the tool wmmenugen to generate a Plist menu specification from a file specification; for example from the XDG application repository.

This can be used to define a menu item with a submenu, or to directly define the toplevel root window.

Example usage:

("Applications...", GeneratePlistMenu, "/usr/bin/wmmenugen -parser:xdg /usr/share/applications/"),