NAME

       tlp - apply laptop power saving settings

SYNOPSIS

       tlp command [parameters] [-- CONFIG_PARAM=value ... ]

DESCRIPTION

       tlp applies power saving settings manually and controls battery care features.

COMMANDS

       start  Initialize  tlp  and  apply  power  saving  settings  according to the actual power
              source. Also use to apply a changed configuration or to leave manual mode.

       bat    Apply the battery settings profile and enter manual mode. Manual  mode  means  that
              changes  to  the power source will be ignored until the next reboot or tlp start is
              issued to resume automatic mode.

       true   Same as bat.

       ac     Apply the AC settings profile and enter manual mode. Manual mode means that changes
              to the power source will be ignored until the next reboot or tlp start is issued to
              resume automatic mode.

       false  Same as ac.

       usb    Enable autosuspend for all USB devices except those excluded by default or  in  the
              configuration.

       bayoff Turn  off  optical  drive  in  UltraBay/MediaBay.   The  drive may be re-enabled by
              pulling the eject lever or pushing the media eject button on newer models.

       Note: charge threshold and recalibration commands below work for specific  laptop  vendors
       and  models  only.  Check the actual support status and the value ranges with tlp-stat -b.
       For details on charge thresholds also refer to the link at the bottom.

       setcharge [START_CHARGE_THRESH STOP_CHARGE_THRESH] [BAT0|BAT1|BATx|CMB0]
              Changes the charge thresholds  for  the  battery  temporarily.   If  your  hardware
              supports  only  a  stop  threshold,  set  the  start value to 0.  Configured charge
              thresholds will be restored at the next boot or by using tlp  setcharge  again  but
              without the threshold arguments.

       fullcharge [BAT0|BAT1|BATx|CMB0]
              Charge  the  battery  to full capacity.  This is done by applying vendor presets to
              the charge thresholds temporarily.  Configured charge thresholds will  be  restored
              at the next boot or by using tlp setcharge without the threshold arguments.

       chargeonce [BAT0|BAT1] (ThinkPads only)
              Charge  the battery to the stop charge threshold once.  This is done by temporarily
              lifting the start charge threshold.  The configured start charge threshold will  be
              restored  at  the  next  boot  or  by  using  tlp  setcharge  without the threshold
              arguments.

       discharge [BAT0|BAT1] (ThinkPads only)
              Force complete discharge of the battery.

       recalibrate [BAT0|BAT1] (ThinkPads only)
              Battery recalibration: completely discharge the battery and recharge to 100%.   The
              latter   is  done  by  temporarily  applying  vendor  presets  to  the  thresholds.
              Configured thresholds will be restored at the next boot or by using tlp setcharge.

       diskid Show disk ids for configuration.

       -- CONFIG_PARAM=value ...
              Add configuration parameters to override the system configuration for  this  single
              program invocation only. They are not kept afterwards.

NOTES

       For laptops with more than one battery the selection works as follows:

              BAT0 - Main or internal battery

              BAT1 - Secondary or replaceable battery

EXAMPLES

       Change thresholds of the main battery to 70 / 90% temporarily:

              tlp setcharge 70 90 BAT0

       Charge the auxiliary battery to full capacity:

              tlp fullcharge BAT1

       Recalibrate the main battery:

              tlp recalibrate BAT0

FILES

       /etc/tlp.conf
              System-wide  user configuration file, uncomment parameters here to override default
              settings and customization files below.

       /etc/tlp.d/*.conf
              System-wide drop-in customization files, overriding defaults below.

       /usr/share/tlp/defaults.conf
              Intrinsic default settings. DO NOT EDIT this file, instead use  one  of  the  above
              alternatives.

       /run/tlp/run.conf
              Effective  settings  consolidated from all above files. DO NOT CHANGE this file, it
              is for reference only and regenerated on every invocation of TLP.

       /etc/default/tlp
              Obsolete system-wide configuration file. DO NOT USE this file, it is evaluated only
              when /etc/tlp.conf is non-existent.

EXIT STATUS

       On success, 0 is returned, a non-zero failure code otherwise.

SEE ALSO

       tlp-stat(8), bluetooth(1), nfc(1), wifi(1), wwan(1).

       Project homepage: ⟨https://linrunner.de/tlp⟩

       Charge thresholds: ⟨https://linrunner.de/tlp/settings/battery.html⟩

AUTHOR

       (c) 2022 Thomas Koch <linrunner at gmx.net>