README.md

FluxboxAppsMenu

FluxboxAppsMenu builds an application's menu for the Fluxbox window manager starting from the desktop files installed by the applications themselves.

Categories and sub-categories listed within these files will be used to assign the related application to the proper folder in order to create a tree representation automatically.

Customizations are allowed enhancing the configuration file.

Installation

Install it as:

$ gem install fluxbox_apps_menu

Configuration

To start with customizations create a copy of the config file (fluxbox_apps_menu.yaml) under the ~/.fluxbox folder using the related command:

$ fluxbox_apps_menu config

Edit it with your favorite editor:

$ vi ~/fluxbox/fluxbox_apps_menu.yaml

Once changes are done build the menu again!

Usage

Build the menu:

$ fluxbox_apps_menu build

When the application menu is built it can be included in your main fluxbox menu file (usually ~/.fluxbox/menu) adding the row below wherever you want to display it:

[include] (~/.fluxbox/menu-apps)

Get help

Where to start:

$ fluxbox_apps_menu help

Get help for a specific task:

$ fluxbox_apps_menu help build
$ fluxbox_apps_menu help config

More help:

More info is available at:

• the project page on the Freeaptitude blog;
• the FluxboxAppsMenu Github wiki.