NAME

gendesk - generate .desktop files based on command-line arguments (or a PKGBUILD file)

SYNOPSIS

gendesk [flags or PKGBUILD file]

DESCRIPTION

Supported PKGBUILD variables that will be included in the generated file:

_name

_genericname

_comment

_mimetype

_exec

_categories

Gendesk will try to find the correct icon from the Open Icon Library or else fall back on the default icon.

The correct application category will be guessed if not provided. Supported environment variables:

pkgname

pkgdesc

EXAMPLES

gendesk
Exits with error code 1 if ../PKGBUILD is not found and pkgname is not given and $pkgname is not defined. Will try to use both $pkgname and $pkgdesc.

gendesk PKGBUILD
Looks for a PKGBUILD in the current directory and generates a .desktop file.

gendesk --pkgname test --pkgdesc test
Generates a .desktop file for the name "test" with the description "test".

gendesk /home/user/archpackages/mypackage/PKGBUILD
Generates a .desktop file from the given PKGBUILD.

A package name must be given, either by specifying a PKGBUILD file, using --pkgname or by defining a $pkgname environment variable.

Note that a "-bin", "-git", "-hg" or "-svn" suffix in a package name will be ignored, if present.

OPTIONS

--version

displays the current version information

-h or --help

displays brief usage information

-n

don't attempt to download an icon, if missing

--nocolor

don't use colored text

-q

quiet; don't output text

-f

force; overwrite files if needed

-wm

generate a small desktop file for launching a window manager instead

--pkgname

use this package name for the application (ie. emacs)

--pkgdesc

use this package description for describing the application and try to find a suitable category

--name

use this name for the desktop shortcut (ie. Emacs)

--genericname

use this generic name for the desktop shortcut (ie. Text Editor)

--comment

use this comment for the desktop shortcut (ie. Use this to edit files)

--exec

specify an alternative executable, (ie. /usr/bin/emacs)

--path

specify a starting path for the program, (ie. /usr/share/kotlin)

--icon

specify an icon filename (defaults to the pkgname)

--categories

specify categories (ie. Utility;TextEditor;)

--terminal

specify if the application should be run in a terminal (default is false)

--mimetypes

specify mime-types

--startupnotify

specify if a desktop notification should occur when the application starts (default is false)

--custom

specify an extra line (or several lines) to append at the end

WHY

Aims to make it easy for package maintainers to add menu entries for the applications they try to package, without including anything that hasn't been supplied by upstream in the package itself.

BUGS

Only unknown bugs so far. Bugs can be reported at https://github.com/xyproto/gendesk/issues.

VERSION

1.0.8

AUTHOR

gendesk was written by Alexander F. Rødseth <xyproto@archlinux.org>