Skip to content

CharOfString/Husky-Panel

Repository files navigation

简体中文 | English

VERSION 1.0.0

Static Badge Static Badge Static Badge Static Badge Static Badge


Husky Panel

A monolithic status bar for Linux desktop.
(Screenshot of HuskyPanel running on KDE Plasma 6 (Wayland session). Wallpaper by Santiago César)

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About The Project

HuskyPanel is another shell bar panel for Linux Wayland session. This is an experimental project that uses Qt Quick (QML) to bring a Material Design 3 styled UI to your desktop environment.

Currenty we are focusing on KWin/KDE Plasma 6.

(back to top)

Built With

  • Qt 6.5+
  • Layer-Shell-Qt
  • Abseil
  • Google Test
  • Libdbusmenu
  • Material-Color-Utilities
  • QWindowKit
  • KDE Framework 6
  • KServices
  • PulseAudio (libpulse)

(back to top)

Getting Started

Ensure that you have Qt version 6.5+ avaliable in your system. This bar uses a new API provided by Qt 6.5+ to aware the change in light/dark scheme. Without the proper version of Qt, the bar could NOT be complied.

Currently only Plasma 6 is supported, we recommend you to login a Plasma 6.5 session to use this bar. Wlroots WM support is planned.

Building

Please read the build instructions:

(back to top)

Usage

Most usage of this bar is pretty straight forward, you just click on the icons on the status bar and a flyout will pop out.

The only hidden menu is for system tray icons. You need to right click on the spare space on the status bar, there is an option called "Configure panel...", that will open a new window, inside there is a system tray icon config, you may choose any items of the tray icons that you would like to hide.

(back to top)

Roadmap

  • Search bar
  • Clock
  • System tray
    • Simple tray
    • Icon folding
  • App indicator
    • KWin support (via KWin script)
    • Niri/Hyprland support
  • Notification manager
  • Network manager
  • Battery manager
  • Volume manager
  • Bluetooth manager
  • App drawer
  • X11 Support

(back to top)

Contributing

Please read CONTRIBUTING.md.

Top contributors

contrib.rocks image

(back to top)

License

Distributed under the GNU GENERAL PUBLIC LICENSE Version 3. See COPYING for more information.

For all the vendored libraries' version, please read lib/3rdparty/VERSION.md.

(back to top)

Contact

To contact me, please utilize the issue.

(back to top)

Acknowledgments

Authors of Third Party Libraries Used

  • Layershell-Qt: KDE.
  • Material Color Utility: Material Foundation.
  • Abseil: Google Inc.
  • Google Test: Google Inc.
  • QWindowKit: Stdware Collections.
  • Qmsetup: Stdware Collections.
  • Syscmdline: SineStriker.
  • libdbusmenu-lxqt: lxqt.
  • Extra CMake Modules: KDE.
  • KDE Frameworks 6: KDE.

(To get full third party library information, please refer this document)

Template & Reference

(back to top)

Packages

 
 
 

Contributors