Waypanel is a lightweight, modular, and highly customizable status panel designed for the Sway and Wayfire. Built with Python and leveraging GTK 4/Adwaita , it mimics a shell-like interface while prioritizing efficiency and extensibility. Supports multiple panels (top, bottom, left, right) with customizable styling. Plugins can append widgets (e.g., system monitors, app launchers) or manage gestures for interactive workflows.
Latest Wayfire and Pywayfire is required
Ensure the following plugins are enabled in your ~/.config/wayfire.ini:
[core]
plugins = ipc ipc-rules stipc scale
git clone https://github.com/WayfireWM/pywayfire
cd pywayfire
sh install
sudo pacman -S gtk4-layer-shell gobject-introspection vala playerctl python-gobject wayland-protocols ninja mesa playerctl libadwaita bluez-tools wl-clipboard
sudo dnf install gtk4 gtk4-layer-shell-devel.x86_64 gobject-introspection vala playerctl python3-gobject ninja libadwaita bluez-tools python3-uv.noarch python-devel wl-clipboard
sudo apt install libgtk-4-dev libgtk4-layer-shell-dev gobject-introspection valac playerctl python3-gi ninja-build libadwaita-1-dev bluez-tools python3-dev python3.13-venv wl-clipboard
Remove any existing configuration from ~/.config/waypanel and ~/.local/share/waypanel for a fresh install.
git clone https://github.com/killown/waypanel.git
cd waypanel
python run.py # This will set up the venv automatically and run the panel
- https://github.com/PapirusDevelopmentTeam/papirus-icon-theme
- https://github.com/SylEleuth/gruvbox-plus-icon-pack
- https://github.com/vinceliuice/Tela-icon-theme
- https://github.com/bikass/kora
- Toggle scale to show all panels. The default activator can be found in /usr/share/wayfire/metadata/scale.xml
scale.mp4
- To add icons to the dockbar, go to the first icon in the top-left (the app launcher), right-click the desired app icon, and select “Add to dockbar.”
add-to-dockbar.mp4
- To adjust panel settings, open the app-launcher and click in settings or edit ~/.config/waypanel/config directly.
waypanel is licensed under the AGPLv3 (GNU Affero General Public License version 3). See LICENSE for more information.