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 **blackbox**,
**compizboxmenu**, **fluxbox**, **icewm**, **jwm**, **pekwm** and
**windowmaker**.
pyxdg and pygtk are required by xdgmenumaker, in addition to python 2.
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 `