MenuLibre 2.3.0 Released

MenuLibre 2.3.0 features experimental support for the MATE desktop environment and improves compatibility with other environments.

MenuLibre 2.3.0 Released

What's New?

New Features

  • Added experimental support for the MATE desktop environment (#40), as found in Solus and Ubuntu MATE
  • Added support for the Unity desktop environment, as found in Ubuntu Unity
  • Added support for the admin:// protocol for editing root-owned files in the parsing errors dialog
  • Added a new prompt for automatically restarting the application menu when edits cannot be immediately applied
  • Added an uninstallation script (not that you’d ever need it)

Bug Fixes

  • AppStream: Do not install (#85)
  • AppStream: Fix screenshot URLs (404 errors)
  • Desktop Environments: Remove empty menubar on Ubuntu's GNOME
  • Editor: Escape quoted percentage arguments (#93)
  • Editor: Fixed copying filename with Ctrl+C
  • Startup: Assume menu loading failed when the menu is empty


  • AppStream: Add OARS rating
  • AppStream: Add developer name

Updated Translations

Catalan, Dutch, Finnish, French, Italian, Lithuanian, Malay, Malay (Arabic), Polish, Spanish

Adding Support for MATE (and other environments)

Adding (or fixing) support for the MATE desktop environment proved to be a challenge. Due to some incompatibility been gnome-menus, xdg-desktop-menu, MATE, and probably something that MenuLibre is doing wrong with all three… MenuLibre was failing to read the MATE directories which resulted in an always-empty menu structure. Getting past that, I found that some updates such as renaming menu items would either fail to update the menu or add duplicate directories.

MenuLibre 2.2.3 failed to detect any menus in the MATE desktop environment.

The first improvement that came out of this series of fixes was to correctly determine that an empty menu is one that failed to load. MenuLibre will now correctly capture this and present the diagnostic dialog at startup to help with reporting a bug.

When MenuLibre correctly detects a loading error, it will display diagnostic information that can be used to identify related issues.

The second improvement was adding support for the vendor-prefixed directory structures. The KDE support already had this to some extent, but it’s now been further refined and should work for any desktop environment. Launchers found in vendor/vendor-*.desktop paths are now properly supported.

Third, and this is when things start getting hacky, was adding support for MATE in such a way that all of the systems would play together nicely. At startup, MenuLibre will now sync vendor directories (e.g. mate/ to your user path and create temporary symbolic links to the top level:

  • ~/.local/share/desktop-directories/mate/
  • ~/.local/share/desktop-directories/

This allows everything to speak the same language. When MenuLibre writes the menu file, it will resolve the real paths so the symbolic links are not needed, and clean up after itself. I don’t love this solution, but it’s proven to be the most stable.

By copying the system directory files and linking to them, MenuLibre is able to correctly read and write to the MATE applications menu.

The final improvement that came from adding support for MATE was accepting that not all menu updates can be made on the fly. MenuLibre will now prompt you to automatically restart your menu (the panels on MATE and Xfce, and Unity shell) when updates fail to apply. This feature is limited to only MATE, Xfce, and Unity for now.

In supported desktop environments, MenuLibre can automatically restart the applications menu to apply any additional updates.

Next Steps

I’m going to continue improving upon MenuLibre in the coming weeks but I’d like to get some early feedback on the features and fixes introduced in MenuLibre 2.3.0. Please report any issues on GitHub and try to refrain from shipping this development release on production systems.

Next, I’m going to start work on a snapshot system that will make it easier to reverse changes or even completely undo the changes MenuLibre makes to your system. There have been far too many reports of failed menu updates and empty menus and MenuLibre needs to better protect its users.


Source tarball (sig)