OS Manuals

/usr/bin/gendesk

Generate .desktop files and download .png icons by specifying a minimum of information

From gendesk 1.0.15-r12 (enterprise-packages), captured 2026-11-09 by running gendesk --help (exit 0) · terse output. permalink

Desktop File Generator 1.0.15
Generate .desktop files.

Syntax: gendesk [flags]

Possible flags:
    --version                    Show application name and version
    -n                           Don't download anything
    --nocolor                    Don't use colors
    -q                           Don't output anything on stdout
    -f                           Overwrite .desktop files with the same name
    -wm                          Generate a .desktop file for launching a window manager
    --pkgname=PKGNAME            The name of the package
    --pkgdesc=PKGDESC            Description of the package
    --path=PATH                  Starting directory
    --name=NAME                  Name of the shortcut
    --genericname=GENERICNAME    Type of application
    --comment=COMMENT            Shortcut comment
    --exec=EXEC                  Path to executable
    --icon=FILENAME              Specify a filename that will be used for the icon
    --terminal=[true|false]      Run the application in a terminal (default is false)
    --categories=CATEGORIES      Categories, see other .desktop files for examples
    --mimetypes=MIMETYPES        Mime types, see other .desktop files for examples
    --startupnotify=[true|false] Notification when the application starts (default is false)
    --custom=CUSTOM              Custom line to append at the end of the .desktop file
    -o, --output=FILENAME        Output .desktop filename, or comma-separated list (one per pkgname) for split PKGBUILDs (defaults to PKGNAME.desktop)
    --help                       This text

Note:
    * Just providing a package name is enough to generate a .desktop file.
    * Providing a PKGBUILD filename instead of flags is a possibility.
    * "$startdir/PKGBUILD" is the default PKGBUILD filename.
    * _exec in the PKGBUILD can be used to specify a different executable for
      the .desktop file. Example: _exec=('appname-gui')
    * Split PKGBUILD packages are supported.
    * If a .png, .svg or .xpm icon is not found as a file or in the PKGBUILD,
      an icon will be downloaded from either the location specified in the
      configuration or from: http://www.iconarchive.com
      (This may or may not result in the icon you wished for).
    * Categories are guessed from keywords in the package description,
      unless specified.
    * Icons are assumed to be found in "/usr/share/pixmaps/" once installed.
    * Adding translations for many languages is not supported by gendesk,
      but it is possible to first generate a file, and then add translations.
Options (20)
OptionDescriptionSource
--versionShow application name and versionhelp
-nDon't download anythinghelp
--nocolorDon't use colorshelp
-qDon't output anything on stdouthelp
-fOverwrite .desktop files with the same namehelp
-wmGenerate a .desktop file for launching a window managerhelp
--pkgname PKGNAMEThe name of the packagehelp
--pkgdesc PKGDESCDescription of the packagehelp
--path PATHStarting directoryhelp
--name NAMEName of the shortcuthelp
--genericname GENERICNAMEType of applicationhelp
--comment COMMENTShortcut commenthelp
--exec EXECPath to executablehelp
--icon FILENAMESpecify a filename that will be used for the iconhelp
--terminal true|falseRun the application in a terminal (default is false)help
--categories CATEGORIESCategories, see other .desktop files for exampleshelp
--mimetypes MIMETYPESMime types, see other .desktop files for exampleshelp
--custom CUSTOMCustom line to append at the end of the .desktop filehelp
-o, --output FILENAMEOutput .desktop filename, or comma-separated list (one per pkgname) for split PKGBUILDs (defaults to PKGNAME.desktop)help
--helpThis texthelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.