diff --git a/README.md b/README.md
index c010fbf..208e201 100644
--- a/README.md
+++ b/README.md
@@ -10,12 +10,30 @@ sorted according to the main categories as specified by
 The menu entries that are generated by xdgmenumaker are localised
 according to the running user locale settings.
 
-xdgmenumaker currently supports generating menus for **fluxbox**,
-**icewm**, **jwm**, **pekwm** and **windowmaker**.
+xdgmenumaker currently supports generating menus for **blackbox**,
+**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)
+
+
 Fluxbox
 =======