ICEWM-MENU-FDO(1)                User Commands               ICEWM-MENU-FDO(1)


   NAME
        icewm-menu-fdo - menu generator for .desktop files

   SYNOPSIS
       icewm-menu-fdo [OPTIONS] [FILENAME]

   DESCRIPTION
       icewm-menu-fdo generates a menu for the IceWM window manager from XDG
       menu descriptors (aka FreeDesktop.Org .desktop files).  By including
       this in the icewm-menu(1), the system applications become available in
       the icewm start menu.

   ARGUMENTS
       [FILENAME]
           The optional FILENAME argument is the location of a .desktop file.
           When given, icewm-menu-fdo launches the application using the
           "Exec" line from the desktop file.

   OPTIONS
       -g, --generic
           Include the generic name in parentheses in the title of prog
           entries.

       --seps
           Print a leading and a trailing separator.

       --sep-before
           Print a leading separator.

       --sep-after
           Print a trailing separator.

       --no-sep-others
           Don't print the "Other" category last.

       --no-sub-cats
           Don't nest subcategories in submenus.

       -o, --output=FILE
           Write the output to FILE.

       -t, --terminal=NAME
           Use NAME to start a terminal emulator that supports the '-e'
           option.

       --flat
           Display apps from all categories in one level with the title
           containing the category information as prefix.

       -F sep, --flat-sep=sep
           When used with "--flat", the specified character sequence is used
           as separator between the section titles.

       -m filter, --match=filter
           Specifies a filter to show only apps that contain this as substring
           within their title.

       -M filter, --imatch=filter
           Like "--match" but applied with any letter case.

       --match-sec
           Apply the filter from "--match" or "--imatch" to both, apps and
           section titles.

       --match-osec
           Apply the filter from "--match" or "--imatch" to only to section
           titles.

       -h, --help
           Print a brief usage statement to stdout and exit.

       -V, --version
           Print the program version to stdout and exit.

       -C, --copying
           Print copying permissions to stdout for the program and exit.

   USAGE
       This utility is not normally used directly. It is used as the
       executable in a menuprog entry in a icewm-menu(5).

   EXAMPLES
       The following line in a icewm-menu(5) file will dynamically generate a
       comprehensive set of menus for easy access to .desktop files.

           menuprog "Desktop Apps" folder icewm-menu-fdo

   ENVIRONMENT
       XDG_DATA_HOME or XDG_DATA_DIRS are considered as suggested by XDG Base
       Directory Specification.

       TERMINAL may define a terminal emulator that supports the '-e' option.

   CONFORMING TO
       icewm-menu-fdo complies roughly to the XDG .desktop file and menu
       specification, see "Desktop Entry Specification", Version 1.2alpha,
       2015-03-06 and "Desktop Menu Specification", Version 1.1-draft, 31
       March 2011.

   CAVEATS
       The icewm-menu-fdo program is only built when the icewm(1) package is
       configured with the --enable-menus-fdo option, which requires the
       glib2-dev package dependency.

   SEE ALSO
       Base Directory Specification, Desktop Entry Specification, Desktop Menu
       Specification, icewm(1), icewm-menu(5), icewm-preferences(5),
       icewm-programs(5).

   BUGS
       Please report bugs at <https://github.com/bbidulock/icewm/issues>.

   AUTHOR
       Eduard Bloch <mailto:edi@gmx.de>.

       See --copying for full copyright notice and copying permissions.

   LICENSE
       IceWM is licensed under the GNU Library General Public License.  See
       the COPYING file in the distribution or use the --copying flag to
       display copying permissions.

icewm 3.6.0                       2024-06-16                 ICEWM-MENU-FDO(1)