Skip to content

Vistaus/batterywatch

 
 

Repository files navigation

BatteryWatch

Latest Release KDE Plasma 6 License Buy Me A Coffee

BatteryWatch is a sleek, modern KDE Plasma 6 widget designed to monitor your device's power ecosystem. Keep track of battery levels for your Bluetooth or wireless devices, like headphones, mouse, keyboard, and game controllers, all from a single, beautiful interface right there in your tray bar!

Screenshots

BatteryWatch Screenshot 1

BatteryWatch Screenshot 2

BatteryWatch Screenshot 3

Features

  • Unified Monitoring - see battery levels of all your devices in one place, right in your system tray
  • Smart Display - minimal tray icon that expands into a detailed list on click, and auto-hides when no devices are connected
  • Customizable Appearance - configure font family, font size, icon size, and per-level battery colors (charging, warning, critical)
  • Customizable Visibility - hide or show specific devices to keep your tray clutter-free

Supported Integrations

Provider What it covers
UPower Bluetooth and wireless peripherals reported by the system - headphones, mice, keyboards, game controllers, and more
OpenLinkHub Corsair and other devices managed by OpenLinkHub
OpenRazer Razer peripherals via OpenRazer
KDE Connect Battery levels of paired KDE Connect devices (phones, tablets, etc), with easy unpair action

Installation

From the KDE Store (Recommended)

  1. Right-click on your desktop or panel.
  2. Select Add Widgets...
  3. Click Get New Widgets... -> Download New Plasma Widgets.
  4. Search for "BatteryWatch" and click Install.

Manual Installation

  1. Download the latest .plasmoid release from the Releases page.
  2. Run the following command:
    kpackagetool6 --type Plasma/Applet --install BatteryWatch.plasmoid

Building from Source

git clone https://github.com/itayavra/batterywatch.git
cd batterywatch
# Zip the contents to create the plasmoid
zip -r BatteryWatch.plasmoid .
# Install
kpackagetool6 --type Plasma/Applet --install BatteryWatch.plasmoid

Development

# Install development version
./dev-install.sh

# Restart Plasma Shell to reload changes
./dev-restart-plasma.sh

# Uninstall development version
./dev-uninstall.sh

Support the Project

If BatteryWatch saves you from digging through menus just to check your headphone battery, consider buying me a coffee - I maintain this in my spare time and it genuinely helps!

Buy Me A Coffee

Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

For instructions on how to contribute translations, add new languages, or test current ones, please refer to the Translation Guide.

Supported Languages

Locale Language Status % Done
he Hebrew ✅ Complete 100%
hu Hungarian ✅ Complete 100%
nl Dutch ✅ Complete 100%
pl polish ✅ Complete 100%

About

A KDE widget to display battery percentage of connected Bluetooth and wireless devices in the system tray

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • QML 81.7%
  • Shell 17.4%
  • JavaScript 0.9%