dms-framework-battery

May 27, 2026 ยท View on GitHub

image

This plugin replaces the existing battery widget for Dank Material Shell. This adds the same features, as well as adding the ability to dynamically change the battery charge limit on Framework laptops.

Note

Charge limit functionality will only work on Framework laptops with ectool. Charge limit functionality can be disabled in the plugin settings if you would like to use this plugin on other devices.

Features

  • Bar shows battery precentage and icon
    • Be able to show time remaining and wattage used
  • When clicked, show more details
    • Battery percent
    • Battery state
    • Battery time remaining
    • Battery wattage used
    • Battery health
    • Battery capacity
    • Set PPD profile
    • Set framework charge limit, with presets and custom mode (60, 75, 80, 90, 100)

Installation

The plugin can be installed from the DMS plugin repository.

Alternatively, it can be installed manually:

cd .config/DankMaterialShell/plugins
git clone https://github.com/nfoert/dms-framework-battery

Then, add the widget to your Dank Bar in Settings > Dank Bar > Widgets. Change plugin settings in Settings > Plugins > DMS Framework Battery.

Development

git clone https://github.com/nfoert/dms-framework-battery
# Broken symlinks may result if you do not specify the full path to wherever you cloned the plugin to
ln -s ~/dms-framework-battery ~/.config/DankMaterialShell/plugins/dmsFrameworkBattery

Enable the plugin in your settings, add it to your bar widgets, then reload it after making changes with:

dms ipc call plugins reload dmsFrameworkBattery

To-Do

  • Get custom charge limit working
  • Fix remaining showing when plugged in
  • Adjust icon colors for charging / discharging / low battery
  • Use RowLayout and ColumnLayout
  • Fix text alignment in stat cards
  • Add widget settings for showing time remaining and wattage used
  • Hide remaining for both the bar widget and inside the component if it's zero
  • Hide wattage on the bar widget if it's zero
  • Wattage seems to always show - instead of + when plugged in
  • Only set the DMS settings for charge limit if the request to set the hardware charge limit succeeded
  • Add button for fetching the current hardware charge limit