mirror of
https://github.com/tmux-plugins/tmux-battery.git
synced 2026-09-10 07:26:19 -04:00
* Upgrade color and icons to have higher granularity
This is a large overhaul of the colors and icons in the plugin to enable
higher granularity. All efforts have been made to have sane defaults.
Additionally, a new 'status' has been added that is a catch-all
'unknown' in case a battery tool acts up or fails to report something
meaningful.
Added 8 new format strings:
* #{battery_color_bg} - will set the background color of the status bar
based on the battery charge level and status
* #{battery_color_fg} - will set the foreground color of the status bar
based on the battery charge level and status
* #{battery_color_charge_bg} - will set the background color of the
status bar based solely on the battery charge level
* #{battery_color_charge_fg} - will set the foreground color of the
status bar based solely on the battery charge level
* #{battery_color_status_bg} - will set the background color of the
status bar based solely on the battery status
* #{battery_color_status_fg} - will set the foreground color of the
status bar based solely on the battery status
* #{battery_icon_charge} - will display a battery charge icon
* #{battery_icon_status} - will display a battery status icon
Removed 2 format strings:
* #{battery_status_bg}
* #{battery_status_fg}
Added 39 new options:
* @batt_color_charge_primary_tier8 - primary color to show at [95%-100%]
battery charge
* @batt_color_charge_primary_tier7 - primary color to show at [80%-95%)
battery charge
* @batt_color_charge_primary_tier6 - primary color to show at [65%-90%)
battery charge
* @batt_color_charge_primary_tier5 - primary color to show at [50%-65%)
battery charge
* @batt_color_charge_primary_tier4 - primary color to show at [35%-50%)
battery charge
* @batt_color_charge_primary_tier3 - primary color to show at [20%-35%)
battery charge
* @batt_color_charge_primary_tier2 - primary color to show at [5%-20%)
battery charge
* @batt_color_charge_primary_tier1 - primary color to show at [0%-5%)
battery charge
* @batt_color_charge_secondary_tier8 - secondary color to show at [95%-
100%] battery charge
* @batt_color_charge_secondary_tier7 - secondary color to show at [80%-
95%) battery charge
* @batt_color_charge_secondary_tier6 - secondary color to show at [65%-
90%) battery charge
* @batt_color_charge_secondary_tier5 - secondary color to show at [50%-
65%) battery charge
* @batt_color_charge_secondary_tier4 - secondary color to show at [35%-
50%) battery charge
* @batt_color_charge_secondary_tier3 - secondary color to show at [20%-
35%) battery charge
* @batt_color_charge_secondary_tier2 - secondary color to show at [5%-
20%) battery charge
* @batt_color_charge_secondary_tier1 - secondary color to show at [0%-
5%) battery charge
* @batt_color_status_primary_charged - primary color to show for a
battery in 'fully-charged' status
* @batt_color_status_primary_charging - primary color to show for a
battery in 'charging' status
* @batt_color_status_primary_discharging - primary color to show for a
battery in 'discharging' status
* @batt_color_status_primary_attached - primary color to show for a
battery in 'attached' status
* @batt_color_status_primary_unknown - primary color to show for a
battery in an unknown status
* @batt_color_status_secondary_charged - secondary color to show for a
battery in 'fully-charged' status
* @batt_color_status_secondary_charging - secondary color to show for a
battery in 'charging' status
* @batt_color_status_secondary_discharging - secondary color to show for
a battery in 'discharging' status
* @batt_color_status_secondary_attached - secondary color to show for a
battery in 'attached' status
* @batt_color_status_secondary_unknown - secondary color to show for a
battery in an unknown status
* @batt_icon_charge_tier8 - icon to show at [95%-100%] battery charge
* @batt_icon_charge_tier7 - icon to show at [80%-95%) battery charge
* @batt_icon_charge_tier6 - icon to show at [65%-90%) battery charge
* @batt_icon_charge_tier5 - icon to show at [50%-65%) battery charge
* @batt_icon_charge_tier4 - icon to show at [35%-50%) battery charge
* @batt_icon_charge_tier3 - icon to show at [20%-35%) battery charge
* @batt_icon_charge_tier2 - icon to show at [5%-20%) battery charge
* @batt_icon_charge_tier1 - icon to show at [0%-5%) battery charge
* @batt_icon_status_charged - icon to show for a battery in 'fully-
charged' status
* @batt_icon_status_charging - icon to show for a battery in 'charging'
status
* @batt_icon_status_discharging - icon to show for a battery in
'discharging' status
* @batt_icon_status_attached - icon to show for a battery in 'attached'
status
* @batt_icon_status_unknown - icon to show for a battery in an unknown
status
Removed 12 options:
* @batt_charged_icon
* @batt_charging_icon
* @batt_attached_icon
* @batt_full_charge_icon
* @batt_high_charge_icon
* @batt_medium_charge_icon
* @batt_low_charge_icon
* @batt_color_full_charge
* @batt_color_high_charge
* @batt_color_medium_charge
* @batt_color_low_charge
* @batt_color_charging
Format string notes:
* #{battery_color_bg} and #{battery_color_fg} replace
#{battery_status_bg} and #{battery_status_fg}, respectively and
continue to act the same way
* #{battery_color_charge_bg/fg} changes colors based ONLY on the battery
charge level
* #{battery_color_status_bg/fg} changes colors based ONLY on the battery
status
* #{battery_icon_charge} displays ONLY an icon for the charge level
* #{battery_icon_status} displays ONLY an icon for the charge status
* #{battery_icon} continues to display both
Option notes:
* @batt_color_..._primary options are what will be displayed in the main
bg or fg you choose - e.g. if you use #{battery_color_bg}, the primary
color will be the background
* Likewise, the corresponding @batt_color_..._secondary option will be
the foreground in the example above
* Fixed #{battery_graph} format string
Previously, the #{battery_graph} format string wouldn't show an actual
graph. This has been fixed. The graph is also 5 characters wide now,
regardless of battery charge level.
* Clarified some language in README.md
* Changed a word because words are hard
|
||
|---|---|---|
| .. | ||
| battery_charging_tier1.png | ||
| battery_charging_tier2.png | ||
| battery_charging_tier3.png | ||
| battery_charging_tier4.png | ||
| battery_charging_tier5.png | ||
| battery_charging_tier6.png | ||
| battery_charging_tier7.png | ||
| battery_charging_tier8.png | ||
| battery_discharging_tier1.png | ||
| battery_discharging_tier2.png | ||
| battery_discharging_tier3.png | ||
| battery_discharging_tier4.png | ||
| battery_discharging_tier5.png | ||
| battery_discharging_tier6.png | ||
| battery_discharging_tier7.png | ||
| battery_discharging_tier8.png | ||
| battery_status_attached.png | ||
| battery_status_unknown.png | ||