Installation - nwg-piotr/nwg-panel GitHub Wiki

Packages

Arch Linux

Install nwg-panel from the [extra] repository. If you'd like to run nwg-panel on a Wayland compositor other than sway, take a look at optional dependencies.

Dependencies

  • bluez-utils
  • gtk-layer-shell
  • gtk3
  • libappindicator-gtk3
  • light or brightnessctl
  • nwg-icon-picker
  • pamixer pre 0.9.7
  • pactl tool for 0.9.7 and newer (can be found in libpulse package on Arch or pulseaudio-utils package on Fedora)
  • playerctl
  • python (python3)
  • python-dasbus
  • python-gobject
  • python-i3ipc
  • python-netifaces
  • python-psutil
  • python-requests
  • python-setuptools (make)
  • python-wheel (make)
  • swaync (optional) – for Sway Notification Center support
  • wlr-randr (optional) – for non-sway Wayland WMs support

Debian GNU/Linux Dependencies

git curl bluez-tools gir1.2-gtklayershell-0.1 libgtk-3-0 pulseaudio-utils gir1.2-dbusmenu-gtk3-0.4 gir1.2-playerctl-2.0 playerctl python3-dasbus python3-gi-cairo python3-i3ipc python3-netifaces python3-psutil python3-requests python3-setuptools python3-wheel sway-notification-center

Additionally, pipewire or pulseaudio for sound, light,brightnessctl or ddcutil for brightness slider, fonts-noto-color-emoji for weather icons, and wlr-randr if you're using Hyprland instead of sway.

Note: Locale variables must be set (sudo dpkg-reconfigure locales).

Installation

git clone https://github.com/nwg-piotr/nwg-panel
git clone https://github.com/nwg-piotr/nwg-icon-picker
cd nwg-panel
sudo ./install.sh && cd ../nwg-icon-picker && sudo ./install.sh

To start

Add to autostart in your sway config file:

exec_always nwg-panel

In case you use the autotiling script on selected workspaces (-w | --workspaces argument), remember to start autotiling before the panel. This way you'll be able to see which workspaces autotiling is active on in the Sway Taskbar.

This will start the panel with settings from the default config file and styling from the style.css file.

Use -c or --config argument to specify a different config file name.

Use -s or --style argument to specify a different css file name.

Use -r or --restore argument to restore default config and style.css.

Running as a systemd service (since v0.7)

Instead of auto-starting the panel, you may use the systemd service:

systemctl --user enable nwg-panel.service

DO NOT USE THIS WITH nwg-shell, as it doesn't pass necessary arguments.