As it seems I'm not going to live long enough to learn C++ properly, I decided to develop my launchers from scratch in Go. You'll find them in the nwg-shell project. They only support sway, and partially other wlroots-based compositors. Nwg-launchers is a community-driven project from now on. The main developer is Siborgium.
It's damned difficult to make all the stuff behave properly on all window managers. My priorities are:
- it must work well on sway;
- it should work as well as possible on Wayfire, i3, dwm and Openbox.
Feel free to report issues you encounter on other window managers / desktop environments, but they may or may not be resolved.
The latest released version is available in Arch User Repository.
Current development version (master branch) may be installed as the nwg-launchers-git AUR package.
For other Linux distributions see the table below.
To build nwg-launchers from source, you need a copy of the source code, which can be obtained by cloning the repository or by downloading and unpacking the latest release.
mesonandninjanlohmann-json- will be downloaded as a subproject if not found on the system
gtkmm3(libgtkmm-3.0-dev)gtk-layer-shell- optional, set toautoby default; will be downloaded as a subproject if explicitly enabled, but not found on the systemlibrsvg- optional, required to support SVG icons
This project uses the Meson build system for building and installing the
executables and the necessary data. The options that can be passed to the
meson command can be found in the meson_options.txt file, and can be used to
disable building some of the available programs.
$ git clone https://github.com/nwg-piotr/nwg-launchers.git
$ cd nwg-launchers
$ meson builddir -Dbuildtype=release
$ ninja -C builddir
To install:
$ sudo ninja -C builddir install
To uninstall:
$ sudo ninja -C builddir uninstall
Note: the descriptions below apply to the master branch. Certain features may or may not be available in the latest
release, as well as in the current package for your Linux distribution.
This command creates a GNOME-like application grid, with the search box, optionally prepended with a row of -f favourites
(most frequently used apps) or -p pinned program icons.
This only works with the -p argument:
- to pin up a program icon, right click its icon in the applications grid;
- to unpin a program, right click its icon in the pinned programs grid.
Hit "Delete" key to clear the search box.
Starting with version 0.6.0 nwggrid can be run in server mode which drastically improves responsiveness.
First, start a server with nwggrid-server command.
When it's up and running, run nwggrid -client to show the grid.
Starting with version 0.7.0 nwggrid has limited support for XDG Desktop Menu Categories.
A list of toggles is displayed between pinned/favorite grids and ordinary one.
Clicking on a button displays entries of said category,
and holding Ctrl allows to select multiple categories at the same time.
Only non-empty categories from the list of "known" categories are shown.
The list can be customized via /your/config/dir/nwg-launchers/nwggrid/grid.conf, a JSON configuration file.
Sample file is provided along with other nwg-launchers sample configuration files.
I plan to move all customization points to JSON config in the future.
If the file is not present, a fixed list of categories is used.
Additionally, you may use -no-categories to disable categories, or set no-categories: false in configuration file.
$ nwggrid -h
GTK application grid: nwggrid 0.7.1.1 (c) 2022 Piotr Miller, Sergey Smirnykh & Contributors
Options:
-h show this help message and exit
-f display favourites (most used entries); does not work with -d
-p display pinned entries; does not work with -d
-d look for .desktop files in custom paths (-d '/my/path1:/my/another path:/third/path')
-o <opacity> default (black) background opacity (0.0 - 1.0, default 0.9)
-b <background> background colour in RRGGBB or RRGGBBAA format (RRGGBBAA alpha overrides <opacity>)
-n <col> number of grid columns (default: 6)
-s <size> button image size (default: 72)
-c <name> css file name (default: style.css)
-l <ln> force use of <ln> language
-g <theme> GTK theme name
-wm <wmname> window manager name (if can not be detected)
-no-categories disable categories display
-oneshot run in the foreground, exit when window is closed
generally you should not use this option, use simply `nwggrid` instead
[requires layer-shell]:
-layer-shell-layer {BACKGROUND,BOTTOM,TOP,OVERLAY}, default: OVERLAY
-layer-shell-exclusive-zone {auto, valid integer (usually -1 or 0)}, default: auto
$ nwggrid-server -h
GTK application grid: nwggrid 0.7.1.1 (c) 2021 Piotr Miller, Sergey Smirnykh & Contributors
Usage:
nwggrid -client sends -SIGUSR1 to nwggrid-server, requires nwggrid-server running
nwggrid [ARGS...] launches nwggrid-server -oneshot ARGS...
See also:
nwggrid-server -h
.desktop files with the Terminal=true line should be started in a terminal emulator. There's no common method
to determine which terminal to use. The nwggrid command since v0.4.1 at the first run will look for installed
terminals in the following order: alacritty, kitty, urxvt, foot, lxterminal, sakura, st, termite, terminator, xfce4-terminal,
gnome-terminal. The name of the first one found will be saved to the ~/.config/nwg-launchers/nwggrid/terminal file.
If none of above is found, the fallback xterm value will be saved, regardless of whether xterm is installed or not.
You may edit the term file to use another terminal.
Use -b | argument (w/o #) to define custom background colour. If alpha value given, it overrides the opacity, as well default, as defined with the -o argument.
On first run the program creates the nwg-launchers/nwggrid folder in your .config directory. You'll find the style.css files inside.
You may edit the style sheet to your liking.
On first run the program creates the nwg-launchers/nwggrid folder in your .config directory. You'll find a sample template grid.conf file inside.
Below lists the keys currently available to be set in the grid.conf file. Not all keys shown below are set by in the sample template, such as the "custom-path" and "language" keys.
It should be noted that the "favorites" and "pins" keys should not be set to true if the "custom-path" key is set, as those options will not work.
{
"categories": {
"AudioVideo" : "Multimedia 📀",
"Development" : "Development 💻",
"Education" : "Education 🎓",
"Game" : "Games 🎮",
"Graphics" : "Graphics 🎨",
"Network" : "Network 🌎",
"Office" : "Office 💼",
"Science" : "Science 🔬",
"Settings" : "Settings ⚙️",
"System" : "System 🖥️",
"Utility" : "Utility 🛠️"
},
"custom-path" : "/my/path1:/my/another path:/third/path",
"favorites" : false,
"pins" : false,
"columns" : 6,
"icon-size" : 72,
"language" : "en",
"no-categories": false,
"oneshot" : false
}This command creates a horizontal or vertical button bar, out of a template file.
$ nwgbar -h
GTK button bar: nwgbar 0.7.1.1 (c) Piotr Miller & Contributors 2022
Options:
-h show this help message and exit
-v arrange buttons vertically
-ha <l>|<r> horizontal alignment left/right (default: center)
-va <t>|<b> vertical alignment top/bottom (default: middle)
-t <name> template file name (default: bar.json)
-c <name> css file name (default: style.css)
-o <opacity> background opacity (0.0 - 1.0, default 0.9)
-b <background> background colour in RRGGBB or RRGGBBAA format (RRGGBBAA alpha overrides <opacity>)
-s <size> button image size (default: 72)
-g <theme> GTK theme name
-wm <wmname> window manager name (if can not be detected)
[requires layer-shell]:
-layer-shell-layer {BACKGROUND,BOTTOM,TOP,OVERLAY}, default: OVERLAY
-layer-shell-exclusive-zone {auto, valid integer (usually -1 or 0)}, default: auto
Use -b | argument (w/o #) to define custom background colour. If alpha value given, it overrides the opacity, as well default, as defined with the -o argument.
On first run the program creates the nwg-launchers/nwgbar folder in your .config directory. You'll find a sample
template bar.json and the style.css files inside.
Templates use json format. The default one defines an example Exit menu for sway window manager on Arch Linux:
[
{
"name": "Lock screen",
"exec": "swaylock -f -c 000000",
"icon": "system-lock-screen"
},
{
"name": "Logout",
"exec": "swaymsg exit",
"icon": "system-log-out"
},
{
"name": "Reboot",
"exec": "systemctl reboot",
"icon": "system-reboot"
},
{
"name": "Shutdown",
"exec": "systemctl -i poweroff",
"icon": "system-shutdown"
}
]To set a keyboard shortcut (using Alt+KEY) for an entry, you can add an underscore before the letter you want to use.
Example to set s as the shortcut:
[
...
{
"name": "Lock _screen",
"exec": "swaylock -f -c 000000",
"icon": "system-lock-screen"
}
...
]
Note for underscore ("_")
If you want to use an underscore in the name, you have to double it ("__").
Wayfire note
For the Logout button, as in the bar above, you may use wayland-logout by @soreau.
You may use as many templates as you need, with the -t argument. All of them must be placed in the config directory.
You may use own icon files instead of icon names, like /path/to/the/file/my_icon.svg.
The style sheet makes the buttons look similar to nwggrid. You can customize them as well.
This program provides 2 commands:
<input> | nwgdmenu- displays newline-separated stdin input as a GTK menunwgdmenu- creates a GTK menu out of commands found in $PATH
Hit "Delete" to clear the search box. Hit "Insert" to switch case sensitivity.
$ nwgdmenu -h
GTK dynamic menu: nwgdmenu 0.7.1.1 (c) Piotr Miller & Contributors 2022
<input> | nwgdmenu - displays newline-separated stdin input as a GTK menu
nwgdmenu - creates a GTK menu out of commands found in $PATH
Options:
-h show this help message and exit
-n no search box
-ha <l>|<r> horizontal alignment left/right (default: center)
-va <t>|<b> vertical alignment top/bottom (default: middle)
-r <rows> number of rows (default: 20)
-c <name> css file name (default: style.css)
-o <opacity> background opacity (0.0 - 1.0, default 0.3)
-b <background> background colour in RRGGBB or RRGGBBAA format (RRGGBBAA alpha overrides <opacity>)
-g <theme> GTK theme name
-wm <wmname> window manager name (if can not be detected)
-run ignore stdin, always build from commands in $PATH
[requires layer-shell]:
-layer-shell-layer {BACKGROUND,BOTTOM,TOP,OVERLAY}, default: OVERLAY
-layer-shell-exclusive-zone {auto, valid integer (usually -1 or 0)}, default: auto
Hotkeys:
Delete clear search box
Insert switch case sensitivity
(1) The program should auto-detect if something has been passed in stdin, and build the menu out of the stdin content
or from commands found in $PATH accordingly. However, in some specific cases (e.g. if you use gdm and start nwgdmenu
from a key binding) the stdin content detection may be false-positive, which results in displaying an empty menu.
In such case use the nwgdmenu -run instead, to force building the menu out of commands in $PATH.
Notice: if you start your WM from a script (w/o DM), only sway and i3 will be auto-detected. You may need to pass the WM name as the argument:
nwgdmenu -wm dwm
The generic name tiling will be accepted as well.
Use -b | argument (w/o #) to define custom background colour. If alpha value given, it overrides the opacity, as well default, as defined with the -o argument.
On first run the program creates the nwg-launchers/nwgdmenu folder in your .config directory. You'll find the
default style.css files inside. Use it to adjust styling and a vertical margin to the menu, if needed.
In case you use default window borders, an exclusion like this may be necessary:
for_window [title="~nwg"] border none
To start nwgdmenu from a key binding, use the -run argument, e.g.:
<keybind key="W-D">
<action name="Execute">
<command>nwgdmenu -run</command>
</action>
</keybind>From 0.5.0 the nwg-launchers support wlr-layer-shell protocol (via gtk-layer-shell), and use it where preferred. The default layer is OVERLAY and the default exclusive zone is auto, but you can change it using command line arguments. Notably, you may want to set exclusive zone to -1 to show nwggrid or nwgbar on top of panels (waybar, wf-panel, etc).
See: https://wiki.archlinux.org/index.php/desktop_entries#Hide_desktop_entries