mirror of https://github.com/nwg-piotr/nwg-drawer.git synced 2024-09-11 14:07:17 +03:00

Application drawer for wlroots-based Wayland compositors

hyprland starred-nwg-piotr-repo starred-repo sway

Go to file

Piotr Miller 955429d809 Merge pull request #7 from nwg-piotr/fix_pinned Fix GTK critical warnings on pinned cache file not found		2021-07-12 23:32:41 +02:00
bin	bump to 0.1.4	2021-07-12 23:26:26 +02:00
desktop-directories	basic layout	2021-05-19 04:38:54 +02:00
.gitignore	Initial commit	2021-05-19 00:45:41 +02:00
drawer.css	default css modified	2021-06-29 17:32:44 +02:00
go.mod	wrong resources path fixed	2021-06-26 23:45:46 +02:00
go.sum	code cleanup	2021-06-17 04:09:03 +02:00
LICENSE	Initial commit	2021-05-19 00:45:41 +02:00
main.go	bump to 0.1.4	2021-07-12 23:26:26 +02:00
Makefile	uninstall fixed	2021-06-23 02:53:56 +02:00
README.md	wrong resources path fixed	2021-06-26 23:45:46 +02:00
tools.go	wrong resources path fixed	2021-06-26 23:45:46 +02:00
uicomponents.go	fix GTK warnings on pinned cache not found #6	2021-07-12 23:23:52 +02:00

README.md

nwg-drawer

This application is a part of the nwg-shell project.

Nwg-drawer is a golang replacement to the nwggrid command (a part of nwg-launchers). It's being developed with sway in mind, but should also work with other wlroots-based Wayland compositors. X Window System is not supported.

The nwg-drawer command displays the application grid. The search entry allows to look for installed applications, and for files in XDG user directories. The grid view may also be filtered by categories.

You may pin applications by right-clicking them. Pinned items will appear above the application grid. Right-click a pinned item to unpin it. The pinned items cache is shared with nwg-menu and nwggrid.

more screenshots | see on YouTube

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 (see command line arguments), but for now the program has only been tested with the two mentioned above.

Steps

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

Building the gotk3 library takes quite a lot of time. If your machine is x86_64, you may skip steps 2-3, and install the provided binary by executing step 4.

Command line arguments

$ nwg-drawer -h
Usage of nwg-drawer:
  -c uint
    	number of Columns (default 6)
  -fm string
    	File Manager (default "thunar")
  -fscol uint
    	File Search result COLumns (default 2)
  -fslen int
    	File Search name length Limit (default 80)
  -is int
    	Icon Size (default 64)
  -lang string
    	force lang, e.g. "en", "pl"
  -o string
    	name of the Output to display the drawer on (sway only)
  -ovl
    	use OVerLay layer
  -s string
    	Styling: css file name (default "drawer.css")
  -spacing uint
    	icon spacing (default 20)
  -term string
    	Terminal emulator (default "alacritty")
  -v	display Version information

Styling

Edit ~/.config/nwg-panel/drawer.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!