Awesome
Tmux ACPI
This tmux
plugin represents acpi
information available on your status bar.
Battery Status & Percentage
Battery status indicator can be either of Discharing
, Charging
, and Not Charging
values.
Battery percentage indicator shows the charged capacity of your battery in percentage from 0 to 100. Of course you will never witness the 0 percent of your battery, not even with time travel.
Battery timer indicator shows how much time remains until battery is dead, or how much time it takes until battery is full. I would recommend using battery status indicator with timer indicator together to distinguish these two states in timer. I used icons to separate the states but you might want to disable these icons by setting their variables as empty.
Battery Capacity & Health
Battery capacity indicator shows the last full charged capacity value of your battery. Note that this has nothing to do with how much time the adapter was connected to your laptop, this is the capacity that is functional! Yes we are all screwed and we don't know it until we see how much capacity is gone. There's not much on seeing dead cells of your battery unless you want to suffer witnessing your battery going down on a daily basis.
Thermal Status
This indicator shows the tempraturue of your device. It could be cold, hot or reach its critical temprature where you should ask yourself what the heck are you doing to your device.
AC-Adapter Status
Usage
Add any of the desired indicators to your status-left
or status-right
tmux
variables as follows:
~/.tmux.conf
set -g status-right '| #{acpi_adapter_status} | #{acpi_battery_percentage} #{acpi_battery_status} ${acpi_battery_timer} | #{acpi_battery_health} #{acpi_battery_capacity} | #{acpi_thermal_status}|'
Available indicators are as follows:
- Battery Percentage:
#{acpi_battery_percentage}
- Battery Timer:
#{acpi_battery_timer}
- Battery Capacity:
#{acpi_battery_capacity}
- Battery Health:
#{acpi_battery_health}
- Battery Status:
#{acpi_battery_status}
- Thermal Status:
#{acpi_thermal_status}
- AC-Adapter Status:
#{acpi_adapter_status}
Installation
- Install Tmux Plugin Manager.
- Add this plugin to your
~/.tmux.conf
:set @plugin 'briansalehi/tmux-acpi'
- Press
[prefix] + I
to install.
Configuration
Following configuration variables can be set in ~/.tmux.conf
.
Variables are shown with their corresponding default values.
~/.tmux.conf
# Colors
set -g @acpi_format_begin '#[fg=white,bg=colour236]'
set -g @acpi_format_end '#[fg=white,bg=black]'
# Icons
set -g @acpi_icon_battery_full 'đ'
set -g @acpi_icon_battery_low 'đĒĢ'
set -g @acpi_icon_battery_charging 'đ'
set -g @acpi_icon_battery_discharging 'â°ī¸ '
set -g @acpi_icon_battery_health 'đŠē'
set -g @acpi_icon_adapter_connected 'âĄī¸'
set -g @acpi_icon_adapter_disconnected 'đ'
set -g @acpi_icon_thermal_cold 'âī¸ '
set -g @acpi_icon_thermal_hot 'đĨ'
set -g @acpi_icon_thermal_critical 'âĸī¸ '
# Values
set -g @acpi_icon_thermal_unit 'Celsius' # Fahrenheit, Kelvin