1I3-DMENU-DESKTOP(1)   User Contributed Perl Documentation  I3-DMENU-DESKTOP(1)
2
3
4

NAME

6           i3-dmenu-desktop - run .desktop files with dmenu
7

SYNOPSIS

9           i3-dmenu-desktop [--dmenu='dmenu -i'] [--entry-type=name]
10

DESCRIPTION

12       i3-dmenu-desktop is a script which extracts the (localized) name from
13       application .desktop files, offers the user a choice via dmenu(1) and
14       then starts the chosen application via i3 (for startup notification
15       support).  The advantage of using .desktop files instead of
16       dmenu_run(1) is that dmenu_run offers all binaries in your $PATH,
17       including non-interactive utilities like "sed". Also, .desktop files
18       contain a proper name, information about whether the application runs
19       in a terminal and whether it supports startup notifications.
20
21       The .desktop files are searched in $XDG_DATA_HOME/applications (by
22       default $HOME/.local/share/applications) and in the "applications"
23       subdirectory of each entry of $XDG_DATA_DIRS (by default
24       /usr/local/share/:/usr/share/).
25
26       Files with the same name in $XDG_DATA_HOME/applications take precedence
27       over files in $XDG_DATA_DIRS, so that you can overwrite parts of the
28       system-wide .desktop files by copying them to your local directory and
29       making changes.
30
31       i3-dmenu-desktop displays the "Name" value in the localized version
32       depending on LC_MESSAGES as specified in the Desktop Entry
33       Specification.
34
35       You can pass a filename or URL (%f/%F and %u/%U field codes in the
36       .desktop file respectively) by appending it to the name of the
37       application. E.g., if you want to launch "GNU Emacs 24" with the patch
38       /tmp/foobar.txt, you would type "emacs", press TAB, type "
39       /tmp/foobar.txt" and press ENTER.
40
41       .desktop files with Terminal=true are started using
42       i3-sensible-terminal(1).
43
44       .desktop files with NoDisplay=true or Hidden=true are skipped.
45
46       UTF-8 is supported, of course, but dmenu does not support displaying
47       all glyphs. E.g., xfce4-terminal.desktop's Name[fi]=Pääte will be
48       displayed just fine, but not its Name[ru]=Терминал.
49

OPTIONS

51       --dmenu=command
52           Execute command instead of 'dmenu -i'. This option can be used to
53           pass custom parameters to dmenu, or to make i3-dmenu-desktop start
54           a custom (patched?)  version of dmenu.
55
56       --entry-type=type
57           Display the (localized) "Name" (type = name), the command (type =
58           command) or the (*.desktop) filename (type = filename) in dmenu.
59           This option can be specified multiple times.
60
61           Examples are "GNU Image Manipulation Program" (type = name), "gimp"
62           (type = command), and "libreoffice-writer" (type = filename).
63

VERSION

65       Version 1.5
66

AUTHOR

68       Michael Stapelberg, "<michael at i3wm.org>"
69

71       Copyright 2012 Michael Stapelberg.
72
73       This program is free software; you can redistribute it and/or modify it
74       under the terms of the BSD license.
75
76
77
78perl v5.34.0                      2021-11-03               I3-DMENU-DESKTOP(1)
Impressum