FreeBSD Manual Pages
I3-DMENU-DESKTOP(1) User Contributed Perl Documentation I3-DMENU-DESKTOP(1) NAME i3-dmenu-desktop - run .desktop files with dmenu SYNOPSIS i3-dmenu-desktop [--dmenu='dmenu -i'] [--entry-type=name] [--show-duplicates] DESCRIPTION i3-dmenu-desktop is a script which extracts the (localized) name from ap- plication .desktop files, offers the user a choice via dmenu(1) and then starts the chosen application via i3 (for startup notification support). The advantage of using .desktop files instead of dmenu_run(1) is that dmenu_run offers all binaries in your $PATH, including non-interactive utilities like "sed". Also, .desktop files contain a proper name, informa- tion about whether the application runs in a terminal and whether it sup- ports startup notifications. The .desktop files are searched in $XDG_DATA_HOME/applications (by default $HOME/.local/share/applications) and in the "applications" subdirectory of each entry of $XDG_DATA_DIRS (by default /usr/local/share/:/usr/share/). Files with the same name in $XDG_DATA_HOME/applications take precedence over files in $XDG_DATA_DIRS, so that you can overwrite parts of the sys- tem-wide .desktop files by copying them to your local directory and making changes. i3-dmenu-desktop displays the "Name" value in the localized version depend- ing on LC_MESSAGES as specified in the Desktop Entry Specification. You can pass a filename or URL (%f/%F and %u/%U field codes in the .desktop file respectively) by appending it to the name of the application. E.g., if you want to launch "GNU Emacs 24" with the patch /tmp/foobar.txt, you would type "emacs", press TAB, type " /tmp/foobar.txt" and press ENTER. .desktop files with Terminal=true are started using i3-sensible-termi- nal(1). .desktop files with NoDisplay=true or Hidden=true are skipped. UTF-8 is supported, of course, but dmenu does not support displaying all glyphs. E.g., xfce4-terminal.desktop's Name[fi]=PAxAxte will be displayed just fine, but not its Name[ru]=DhcDh<micro>NDh1/4Dh,Dh1/2Dh<degree>Dh>>. OPTIONS --dmenu=command Execute command instead of 'dmenu -i'. This option can be used to pass custom parameters to dmenu, or to make i3-dmenu-desktop start a custom (patched?) version of dmenu. --entry-type=type Display the (localized) "Name" (type = name), the command (type = com- mand) or the (*.desktop) filename (type = filename) in dmenu. This op- tion can be specified multiple times. Duplicates will be removed, see '--show-duplicates'. Examples are "GNU Image Manipulation Program" (type = name), "gimp" (type = command), and "libreoffice-writer" (type = filename). --show-duplicates Show duplicates if '--entry-type' is specified multiple times. VERSION Version 1.5 AUTHOR Michael Stapelberg, "<michael at i3wm.org>" LICENSE AND COPYRIGHT Copyright 2012 Michael Stapelberg. This program is free software; you can redistribute it and/or modify it un- der the terms of the BSD license. perl v5.40.0 1980-01-01 I3-DMENU-DESKTOP(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | VERSION | AUTHOR | LICENSE AND COPYRIGHT
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=i3-dmenu-desktop&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>