ABOUT
=====
**xdgmenumaker** is a command line tool, written in python, that generates
application menus using xdg information, by scanning `*.desktop` files
in all `$XDG_DATA_DIRS/applications` directories. All applications are
sorted according to the main categories as specified by
[freedesktop.org](http://standards.freedesktop.org/menu-spec/latest/apa.html).
The menu entries that are generated by xdgmenumaker are localised
according to the running user locale settings.
xdgmenumaker currently supports generating menus for:
* amiwm
* blackbox
* compizboxmenu
* fluxbox
* fvwm
* icewm
* jwm
* pekwm
* twm and derivatives such as ctwm and vtwm
* windowmaker
**xdgmenumaker** requires:
* Python 3.x
* pyxdg
* pygobject and gobject-instrospection
* Pillow (optional)
USAGE
=====
AmiWM
-----
You can generate a menu for AmiWM, running xdgmenumaker like this:
$ xdgmenumaker -f amiwm > ~/.amiwm-xdgmenu
As AmiWM does not support including other files in its settings file,
you'll have to copy the contents of the created file in your
`~/.amiwmrc`. It should be possible to create a script that would
generate the main `~/.amiwmrc` file from different "source" files, but
I'll leave that as an exercise to the user.
Blackbox
--------
To generate an application menu for blackbox, run xdgmenumaker like this:
$ xdgmenumaker -f blackbox > ~/.blackbox/xdg_menu
and then change your main blackbox menu to include this file as a
submenu. For example, add this somewhere in your `~/.blackbox/menu` file:
[include] (~/.blackbox/xdg_menu)
You can add the xdgmenumaker command as another item in your menu, if
you want to update it, without having to run the command manually again:
[exec] (Update Blackbox Menu) {xdgmenumaker -f blackbox > ~/.blackbox/xdg_menu}
Compiz Boxmenu
--------------
There are two ways to have an xdg menu in compiz-boxmenu. The first one,
auto-updates the menu, every time the menu is called. The second one,
updates the menu only when the user wants to.
### Dynamic Menus
Edit your `~/.config/compiz/boxmenu/menu.xml` file with your favorite text
editor and add a block of code like this inside the root `