Wattage

Wattage is an application designed for monitoring the health and status of your power devices. It displays quick data regarding battery capacity, energy metrics, and device information through a clean, modern GTK 4 and libadwaita interface.

Notices

Wattage does not support Windows, macOS, or any system that does not support retrieving power information from UPower. However, nearly all Linux distributions with a user interface or desktop environment (such as GNOME, KDE Plasma, etc.) have UPower installed, so Wattage should work on almost all desktops. Some BSD operating systems also support UPower, but full functionality is not guaranteed.

Features

• Monitor a variety of statistics regarding your battery.
• View battery health, voltage data, model information, manufacturing details, and device status.
• Support for multiple batteries or power sources.
• Interface built with GTK 4 and libadwaita.
• Written in Vala, which is fast since it compiles to C.
• Designed for systems with UPower power information.

Installation

The following guide provides instructions on how to install Wattage on your device.

Manual Installation

Build Requirements

• Vala
• Foundry
• libadwaita (version >= 1.8) and GTK 4
• pkgconf

Other requirements should be installed automatically as dependencies of the packages above.

Build Instructions

The steps for manually building Wattage is quite straightforward. Before starting, please make sure you installed all necessary requirements listed above.

1. Clone the repository:

git clone https://github.com/v81d/wattage.git
cd wattage

2. Configure the build directory with Foundry:

foundry init

3. Build the project:

foundry build

4. Run the app:

foundry run

Export as Flatpak

If you do not want to install the app via the official Flathub page, you can build it manually. Make sure Flatpak is installed. Then, use Foundry to export the artifact:

foundry export

This should output a .flatpak file to a dedicated directory (e.g., .foundry/cache/flatpak/staging/x86_64-develop/io.github.v81d.Wattage-x86_64.flatpak). You can install the bundle with the following commands:

flatpak install --user -y <PATH_TO_ARTIFACT>

To start the app, select it from your launcher or run:

flatpak run io.github.v81d.Wattage

Contributing

Reporting Issues

To report an issue or bug, visit Wattage's issue tracker on GitHub.

Translating the Project

You can contribute by adding translations for strings in the application. See TRANSLATING.md for more information.

Pull Requests

To push your features or fixes into this official repository:

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/my-feature) or a fix branch (git checkout -b fix/my-fix).
3. Commit your changes (git commit -m "feat: add new feature"). Please follow the Conventional Commits guideline when doing so!
4. Push the branch (git push origin feature/my-feature).
5. Open a pull request with contrib as the base branch. Make sure to create a detailed title and description of your change.

Please follow the GitHub flow and the GNOME Code of Conduct when submitting a pull request.

License

Wattage is free software distributed under the GNU General Public License, version 3.0 or later (GPL-3.0+).

You are free to use, modify, and share the software under the terms of the GPL. For full details, see the GNU General Public License v3.0.