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>

TLP 1.5.0                                          2021-12-18                                             tlp(8)