nwg-menu

README

nwg-menu

This code provides the MenuStart plugin to nwg-panel. It also may be used standalone, however, with a little help from command line arguments.

The nwg-menu command displays the system menu with simplified freedesktop main categories (8 instead of 13). It also provides the search entry, to look for installed application on the basis of .desktop files, and for files in XDG user directories.

You may pin applications by right-clicking them. Pinned items will appear above the categories list. Right-click a pinned item to unpin it. The pinned items cache is shared with the nwggrid command, which is a part of nwg-launchers.

In the bottom-right corner of the window you'll also see a set of buttons: logout, lock screen, restart and shutdown. The commands attached to them may be defined in the nwg-panel settings or given as the arguments.

To use the menu standalone (e.g. with another panel/bar or with a key binding), take a look at arguments:

$ nwg-menu -h
Usage of nwg-menu:
  -cmd-lock string
    	screen lock command (default "swaylock -f -c 000000")
  -cmd-logout string
    	logout command (default "swaymsg exit")
  -cmd-restart string
    	reboot command (default "systemctl reboot")
  -cmd-shutdown string
    	shutdown command (default "systemctl -i poweroff")
  -d	auto-hiDe: close window when left
  -fm string
    	File Manager (default "thunar")
  -ha string
    	Horizontal Alignment: "left" or "right" (default "left")
  -height int
    	window height
  -isl int
    	Icon Size Large (default 32)
  -iss int
    	Icon Size Small (default 16)
  -lang string
    	force lang, e.g. "en", "pl"
  -mb int
    	Margin Bottom
  -ml int
    	Margin Left
  -mr int
    	Margin Right
  -mt int
    	Margin Top
  -o string
    	name of the Output to display the menu on
  -padding uint
    	vertical item padding (default 2)
  -s string
    	Styling: css file name (default "menu-start.css")
  -term string
    	Terminal emulator (default "alacritty")
  -v	display Version information
  -va string
    	Vertical Alignment: "bottom" or "top" (default "bottom")
  -width int
    	window width
  -wm string
      use swaymsg exec (with 'sway' argument) or hyprctl dispatch exec (with 'hyprland') or riverctl spawn (with 'river') to launch programs

Installation

Dependencies

• go 1.16 (just to build)
• gtk3
• gtk-layer-shell

Optional (recommended):

• thunar
• alacritty

You may use another file manager and terminal emulator, but for now the program has not yet been tested with anything but the two mentioned above.

Steps

1. Clone the repository, cd into it.
2. Install necessary golang libraries with make get.
3. make build
4. sudo make install

Running

Plugin integration and the config GUI has been available in the nwg-panel since the 0.3.1 version, see Wiki. You may also start the menu from another panel or a key binding.

Styling

Edit ~/.config/nwg-panel/menu-start.css to your taste.

Credits

This program uses some great libraries:

• gotk3 Copyright (c) 2013-2014 Conformal Systems LLC, Copyright (c) 2015-2018 gotk3 contributors
• gotk3-layershell by @dlasky - many thanks for writing this software, and for patience with my requests!
• go-sway Copyright (c) 2019 Joshua Rubin
• go-singleinstance Copyright (c) 2015 Allan Simon

The nwg-shell logo (which is also the menu button graphics) created by SGSE, licensed under the terms of the Creative Commons license CC BY 4.0.