Reports and your data
Your battery data belongs to you. Battery Health Center can export it as a readable report or as spreadsheet-friendly files, and it stores everything in plain files in your home folder.
Battery report (HTML)#
Choose Export Battery Report… from the main menu, pick a file name, and the app saves a single self-contained HTML page you can open in any browser, print, email or keep. It is useful for a warranty claim, or to show a buyer when you sell the laptop. A Open button in the confirmation opens it straight away.
The report has these sections:
- Battery: a table for each battery with the manufacturer, model, chemistry, design and full-charge capacity, maximum capacity, condition, cycle count and more.
- Capacity Over Time: the daily capacity chart.
- Battery Level, Last 7 Days: the level chart with charger periods.
- Battery Use During Sleep: the recorded sleep sessions.
- Apps by Energy Use, Last 7 Days: the top apps with estimated use.
The report is in English whatever your system language.
Export data as CSV#
Choose Export Data as CSV…, pick a folder, and choose Save Here. The app writes four files you can open in a spreadsheet or load into your own tools (the confirmation says how many files were saved):
| File | Contents |
|---|---|
battery-history.csv | Battery level and power samples, one per minute (kept for 30 days). |
capacity-history.csv | The daily capacity readings used for the trend. |
sleep-sessions.csv | Each recorded sleep session and how much battery it used. |
app-energy.csv | Each app's CPU use and estimated energy, per hour (kept for 7 days). |
Timestamps use the ISO 8601 format with your time zone, for example 2026-11-07T08:15:00-05:00.
From the command line#
Both exports also work without opening the window, which is handy for scripts and scheduled backups:
battery-health-center --export-report report.html
battery-health-center --export-csv ~/battery-dataThe CSV command prints the path of each file it wrote.
Where your data is stored#
| Location | What it holds |
|---|---|
~/.local/share/battery-health-center/history.csv | Battery samples, once a minute, for the last 30 days. |
~/.local/share/battery-health-center/health.csv | The daily capacity readings used for the trend. |
~/.local/share/battery-health-center/app-history.csv | Per-app energy by the hour, for the last 7 days. |
~/.config/battery-health-center/settings.ini | Your preferences. |
~/.config/autostart/io.github.BatteryHealthCenter.desktop | Present only when background recording is on. |
The charge limit and the schedule are stored by the root helper, outside your home folder (see Reference). To start over, quit the app and delete the files you want to reset.
Writes are made safely: preferences are replaced atomically, and if a save fails the app keeps the previous file, shows a banner with the path and the error, and retries the history when storage recovers.