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)