1I3-DMENU-DESKTOP(1) User Contributed Perl Documentation I3-DMENU-DESKTOP(1)
2
3
4
6 i3-dmenu-desktop - run .desktop files with dmenu
7
9 i3-dmenu-desktop [--dmenu='dmenu -i'] [--entry-type=name]
10
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
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
65 Version 1.5
66
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.28.1 2019-01-27 I3-DMENU-DESKTOP(1)