A signed apt repository for Battery Health Center, a GNOME app that shows everything about your laptop battery in one place: health and cycle count, charge limits and profiles to reduce wear, a charging schedule and optimized charging, battery use during sleep, power modes and power-saving settings, battery-saving tips, and which apps use the most energy (with an hour-by-hour view for each app). You can export your history as CSV.
Repository address: https://arios4k.github.io/apt
· Web page: arios4k.github.io/apt
· Project and issues: arios4k/battery-health-center
Latest version: 0.6.6 · Languages: English, Spanish (español) and German (Deutsch). The app follows your system language.
This repository is how Battery Health Center is distributed: install it once and apt keeps it up to
date. (If you installed an older version as a snap, see Troubleshooting.)
The Power page, with power modes and GNOME's power-saving settings, is only in the apt version.
- Screenshots
- Install
- Which systems it works on
- Languages
- Check the signing key
- Update and remove
- Other ways to add the repository
- What gets installed
- Troubleshooting
- How the repository is built (for maintainers)
Add the repository once, then install the app. After that, apt keeps it up to date together with
the rest of your system.
sudo install -d -m 0755 /etc/apt/keyringscurl -fsSL https://arios4k.github.io/apt/key.asc | sudo tee /etc/apt/keyrings/battery-health-center.asc > /dev/nullecho "deb [signed-by=/etc/apt/keyrings/battery-health-center.asc] https://arios4k.github.io/apt stable main" | sudo tee /etc/apt/sources.list.d/battery-health-center.listsudo apt update && sudo apt install battery-health-centerThen open Battery Health Center from your applications.
What each command does:
| Step | Purpose |
|---|---|
install -d …/keyrings |
Makes sure the folder for apt's signing keys exists (it already does on current systems). |
curl … key.asc | tee … |
Downloads the repository's public signing key. apt uses it to check that packages come from this project and weren't altered. |
echo "deb [signed-by=…] …" |
Adds the repository. signed-by limits the key to this repository only, so it can't vouch for any other software. |
apt update && apt install |
Reads the repository's index and installs the app with everything it needs. |
The package is built for 64-bit Intel/AMD (amd64) and needs glibc 2.39, GTK 4.14 and libadwaita 1.5 or newer.
| System | Status |
|---|---|
| Ubuntu 24.04 LTS | Tested (clean install in a container) |
| Zorin OS 18 | Tested (the author's laptop) |
| Linux Mint 22 | Tested |
| Debian 13 ("trixie") and newer | Expected to work (newer libraries), not tested |
| Ubuntu 22.04, Linux Mint 21, Debian 12 | Not supported: their libraries are too old |
| arm64 and other architectures | Not supported: only amd64 is published |
On an unsupported system apt install stops with a message like
Depends: libc6 (>= 2.39) but 2.35-0ubuntu3 is to be installed. Nothing is changed.
The app itself is for laptops with a battery. Charge limits additionally need firmware that exposes charge thresholds to the kernel (ThinkPads and many other laptops do); everything else works on any laptop.
| Language | Status |
|---|---|
| English | Original |
| Spanish (español) | Included since 0.3.3 |
| German (Deutsch) | Included since 0.3.3 |
The app uses your system language and shows English for anything that isn't translated. To try another
language for one run, start it from a terminal, for example LANGUAGE=de battery-health-center. (Your
system needs that language's locale installed for the system language to be picked up automatically; the
LANGUAGE variable works either way.) The exported HTML battery report is still English only.
The translations are written by the author and a native speaker's review is welcome. To add a language or fix a translation, see Translations in the project's README.
Every package and the repository index are signed with one key:
| Name | Battery Health Center Packages <182820807+arios4k@users.noreply.github.com> |
| Fingerprint | F090 D01D 74F7 14C8 5A95 23CA 4773 367E BD97 6CF5 |
| Type | RSA 4096, signing only, never expires |
| Created | 2026-10-26 |
| Download | key.asc |
To check that the key you downloaded is the right one, print its fingerprint and compare the long line with the one above:
gpg --show-keys --with-fingerprint /etc/apt/keyrings/battery-health-center.ascThe same fingerprint is published in three places that you can compare: this page, the web page, and the project README.
sudo apt update && sudo apt upgradeUpdates arrive together with your normal system updates.
Remove the app (keeps its saved settings and charge limit file):
sudo apt remove battery-health-centerRemove it completely, including the service's state, and stop using the repository:
sudo apt purge battery-health-centersudo rm /etc/apt/sources.list.d/battery-health-center.list /etc/apt/keyrings/battery-health-center.ascGood to know: uninstalling does not undo a charge limit. The battery keeps the limit you set until you change it (some laptops even keep it across restarts). To go back to charging to 100%:
echo 100 | sudo tee /sys/class/power_supply/BAT0/charge_control_end_threshold(use charge_stop_threshold instead if that is the file your laptop has, and replace BAT0 if your battery
is named differently).
Instead of the .list file above, current systems also accept this format. First download the key as in
the install steps, then:
sudo tee /etc/apt/sources.list.d/battery-health-center.sources > /dev/null <<'EOF'
Types: deb
URIs: https://arios4k.github.io/apt
Suites: stable
Components: main
Architectures: amd64
Signed-By: /etc/apt/keyrings/battery-health-center.asc
EOFUse one format or the other, not both.
The package file is in the repository's pool folder:
https://arios4k.github.io/apt/pool/main/b/battery-health-center/battery-health-center_<version>-1_amd64.deb
Download it, check its SHA-256 against the SHA256: line for the package in
Packages, and install it with
sudo apt install ./battery-health-center_<version>-1_amd64.deb. Installing this way means no automatic
updates. Only the newest version is kept in the repository; older ones are removed.
| Path | What it is |
|---|---|
/usr/bin/battery-health-center |
The app |
/usr/libexec/battery-health-center/bhc-helper |
A small helper that changes the charge limit. It runs as root when you apply a limit or save a schedule (after a PolicyKit password prompt), and as the schedule service below. It accepts only checked values |
/usr/share/polkit-1/actions/io.github.BatteryHealthCenter.policy |
The PolicyKit rule for that prompt |
/usr/lib/systemd/system/battery-health-center-restore.service |
Re-applies your saved charge limit at boot and after sleep (enabled automatically) |
/usr/lib/systemd/system/battery-health-center-scheduler.path and .service |
Carry out your charging schedule without asking for a password each time. The .path unit starts the service only while a schedule exists, and the service stops when you remove the schedule |
/usr/share/locale/{de,es}/LC_MESSAGES/battery-health-center.mo |
The German and Spanish translations |
| Launcher, icon, AppStream metadata, man page | The usual desktop files |
Files the app creates for you:
| Path | Contents |
|---|---|
~/.local/share/battery-health-center/ |
Battery history, daily capacity log, per-app energy history |
~/.config/battery-health-center/settings.ini |
Your preferences |
~/.config/autostart/io.github.BatteryHealthCenter.desktop |
Only if you turn on "Record History in the Background" |
/etc/battery-health-center.conf |
Your saved charge limit |
/etc/battery-health-center.schedule |
Your charging schedule and the optimized charging setting (only if you save one) |
/var/lib/battery-health-center/unplug-log |
When you unplugged the laptop, kept only while optimized charging is on, to learn your routine. It never leaves your computer |
Removing the app leaves these in place. Delete them yourself if you want a clean slate.
| What you see | Why | What to do |
|---|---|---|
NO_PUBKEY 4773367EBD976CF5 and The repository 'https://arios4k.github.io/apt stable InRelease' is not signed. |
The signing key is missing or the signed-by path is wrong |
Repeat the curl … key.asc step and check that the path in the .list file matches |
Unable to locate package battery-health-center |
The repository isn't added, or apt update wasn't run |
Check that /etc/apt/sources.list.d/battery-health-center.list exists, then sudo apt update |
The following packages have unmet dependencies … libc6 (>= 2.39) |
The system is too old (see Which systems it works on) | Upgrade the system to a supported release |
404 Not Found or Failed to fetch for arios4k.github.io |
A typo in the address, no internet, or the site is rebuilding after a release | Check the address, wait a few minutes and run sudo apt update again |
| The app's icon is blank in the app list | A stale icon cache from an older install made with the project's install.sh |
sudo gtk-update-icon-cache -f -t /usr/local/share/icons/hicolor, then log out and in |
| You installed an older version as a snap, and now also this package | Both would manage the charge limit | Remove the snap: sudo snap remove battery-health-center. That deletes its history, so first copy ~/snap/battery-health-center/current/.local/share/battery-health-center/*.csv to ~/.local/share/battery-health-center/ |
| The charge limit asks for a password every time | PolicyKit remembers it only for a few minutes | This is expected; it is what keeps the helper safe |
| The Charging Schedule section is greyed out | A schedule needs a saved charge limit | On the Charging page turn on Limit Maximum Charge and Keep After Restart, press Apply, then set the schedule |
| The schedule doesn't seem to do anything | The service isn't running, or the laptop's clock or time zone is wrong | systemctl status battery-health-center-scheduler.path battery-health-center-scheduler.service (the service runs only while /etc/battery-health-center.schedule exists) and timedatectl |
| Something else | Open an issue with your distribution and apt-cache policy battery-health-center |
This part is for maintainers.
dists/stable/
InRelease the index, signed (clear-signed)
Release, Release.gpg the same index with a detached signature
main/binary-amd64/Packages(.gz) package list with versions and SHA-256 checksums
pool/main/b/battery-health-center/ the .deb file
key.asc the public signing key
index.html the web page
apt downloads InRelease, checks its signature against the key, then trusts the checksums inside it
for Packages, and the checksums in Packages for the .deb. A changed or swapped file fails the check.
The repository uses suite stable, component main and architecture amd64. It is a plain static site
served by GitHub Pages from the main branch; .nojekyll stops GitHub from processing it.
Everything is done from the application repository:
bump the version in Cargo.toml, add an entry to data/deb/changelog, then run
scripts/publish-apt.shIt builds the package with cargo deb, adds it with reprepro, signs the index and commits and pushes
this repository. DRY_RUN=1 scripts/publish-apt.sh shows the steps without doing anything. reprepro
keeps only the newest version of the package, so the previous file is deleted from pool/ and the next
release replaces it.
| Place | Contents | Published? |
|---|---|---|
This repository (~/apt-site) |
dists/, pool/, key.asc, index.html, this README |
Yes |
~/apt-repo/conf/ |
reprepro's configuration (distributions, options) |
No |
~/apt-repo/db/ |
reprepro's database |
No |
~/.gnupg/ |
The private signing key | Never |
~/signing-key-backup/ |
An encrypted copy of the key, its public half and a revocation certificate | Never (keep offline) |
conf/distributions contains:
Origin: Battery Health Center
Label: Battery Health Center
Codename: stable
Suite: stable
Architectures: amd64
Components: main
Description: Battery Health Center packages
SignWith: F090D01D74F714C85A9523CA4773367EBD976CF5
and conf/options sets outdir to the folder of this repository.
The private key is protected by a passphrase and backed up offline. If it is lost, or if it is stolen and you can't be sure the passphrase held:
- Import the revocation certificate from the backup (
gpg --import revocation-certificate.asc) and publish the revoked public key askey.asc. - Create a new key, put its fingerprint in
conf/distributions, republish, and tell users to replace/etc/apt/keyrings/battery-health-center.asc.
Until users replace the key, apt update will report the repository as untrustworthy, which is the point.
The packages are licensed under the GNU General Public License, version 3 or later; see the project for the source code.






