Bugs and Debugging

If you encounter issues with this extension, please follow these steps:

  1. Check if your laptop is supported under Device Compatibility.
  2. Check for any required dependencies. You will find them listed under Device Compatibility > [Make/Model] > Dependencies.
  3. Disable the extension, and set the mode or threshold using the command line. Instructions can be found under Device Compatibility > [Make/Model] > Testing charging threshold using command-line.
  4. Reset the gsettings for this extension. First, disable the extension using the Extensions or Extension Manager app. To reset gsettings for the Battery Health Charging extension, use the command below in the terminal:
    gsettings --schemadir /home/$USER/.local/share/gnome-shell/extensions/Battery-Health-Charging@maniacx.github.com/schemas reset-recursively org.gnome.shell.extensions.Battery-Health-Charging
  5. Check the extension by enabling it again in the Extensions or Extension Manager app.
  6. If the issue still persists, Raise an issue on Github.
  7. When reporting the issue, include the following details:
    • Gnome Version (found in the about section of your desktop settings (Gnome Control Center))
    • Operating system (e.g., Ubuntu 22.04)
    • Laptop Make and Model (e.g., Asus Vivobook)

Although there are no logs included in this extension, you can still monitor for any errors in the log by using the following commands in the terminal:

For Gnome Shell - logs related to the extension:

journalctl -f -o cat /usr/bin/gnome-shell

For GJS - logs related to extension preferences:

journalctl -f -o cat /usr/bin/gjs

Command Line Tips

#List UUID of all extensions installed
gnome-extensions list

#Enable extension using UUID
gnome-extensions enable Bluetooth-Battery-Meter@maniacx.github.com

# Open extension prefs using UUID
gnome-extensions prefs Bluetooth-Battery-Meter@maniacx.github.com

#Disable extension using UUID
gnome-extensions disable Bluetooth-Battery-Meter@maniacx.github.com

#Disable all extensions
gsettings set org.gnome.shell disable-user-extensions true

#Enable all extensions
gsettings set org.gnome.shell disable-user-extensions false

# Kill gnome-shell
killall -3 gnome-shell

# Force shutdown
sudo reboot -f

This can be helpful if gnome shell freezes (GUI stops). You can always move to terminal session using keys CTRL+ALT+F3, login, disable extension (if you know extension causing the problem) or disable all extension, kill gnome shell. Use CTRL+ALT+F1 to login to display session.

Feature Request

New Feature

For new feature requests or support for new laptop models, Raise an issue on Github.

Support New Model

The charging threshold is a hardware feature controlled by the laptop’s Embedded Controller, which sets the charging limits even when the laptop is powered off. It is not a software feature.

To request support for a new laptop model:

  1. Verify that the laptop has the hardware capability to change the charging limit/threshold. This is usually evident in the system BIOS or software apps provided by the OEM.
  2. Confirm that the laptop can change the charging limit/threshold in Linux.
  3. Raise an issue on Github with a detailed description of the commands or procedure used to change the threshold.

Back to top