10 years ago
What is Mint-FM2?
Mint-FM2 is the auto-generated and auto-updating menu system used in Mint 9 Fluxbox Edition and newer. Releases older than this use an older version which is very different. The menu is accessed by right clicking on the desktop in Fluxbox.
The generated menu is compliant with the freedesktop.org standards. Hence, it is comparable to menus found in other desktop environments like Gnome, KDE, etc. Also, it will generate the menu in the user's default language provided translations are available and it can detect application icons provided the icon is supported by Fluxbox (PNG or XPM format).
In normal use, Mint-FM2 is designed to take care of the Fluxbox menu for you. No user input or maintenance is required (if all works well). It generates the menu and it keeps it updated automatically.
Mint-FM2 can be run from the terminal with the following options
Installed files and directories
The system files for Mint-FM2 are installed in /usr/lib/linuxmint/mint-fm2/. In addition to this directory, when Mint-Fm2 is run for the first time, it creates the Fluxbox menu file ~/.fluxbox/menu, the custom menu file explained below and a hidden folder ~/.mint-fm2 which contains the auto-generated menu and other files it requires.
The configuration file
Keeping with the spirit of Fluxbox, Mint-FM2 is highly configurable. The default location for the Mint-FM2 configuration file is ~/.mint-fm2/mint-fm2.conf. A copy of the default configuration file is located at /usr/lib/linuxmint/mint-fm2/mint-fm2.conf. If you need to restore the default settings you can replace your configuration file with this one.
Examples and available options for the various configurations are available in the configuration file itself.
Custom menu entries file
This is the file defined in the FBCUSTOM option above. In this file you can add entries or import other files, etc using the standard Fluxbox format for menus. The entries in this file will be included into the menu in the location determined by the ENTRYORDER option.
Menu entry tags
The auto-generated menu entries are stored in files located in ~/.mint-fm2/submenus. A file for the menu categories and one for each category is created, all in standard Fluxbox menu format.
A 'tag' is appended to each entry when it is created. Whenever the menu is updated, Mint-FM2 checks the tag for each entry. This provides the user the option to instruct Mint-FM2 how to deal with the entry. There are three (3) available states for each entry.
The above information should be enough for almost all situations. Below is information for more advanced use and debugging. It is not required for normal use.
The debug mode is a customized Bash shell which can be used in a variety of ways for more complex tasks. Customizations of the Bash shell include:
While in debug mode, run 'welcomeMsg' and 'help' for some information.
Debug mode use cases
* 'Mint-FM2 >>' in the code below is to differentiate the debug mode from normal Bash shell. You do not have to type it.
Yes, this is for version Mint 9 Fluxbox and later. It is still in testing. This version is a lot different from previous versions... many improvements were made. And since the Wiki is down and I needed to update the documentation for the upcoming release, posted here.
I hope it will be useful and if you need more clarification on anything, just let me know.
Good one Shane!