tlp
Start or restart TLP
Start TLP and apply profile for the current power source:
sudo tlp start
Note
Also use this command to apply changes after editing the configuration.
TLP Profiles
Version 1.9 and newer
Apply the performance profile (_AC parameters):
sudo tlp performance
Apply the balanced profile (_BAT parameters):
sudo tlp balanced
Apply the power-saver profile (_SAV parameters):
sudo tlp power-saver
Manual Mode
Manual mode means that changes to the power source will be ignored until the next reboot. Instead, tlp start can also be used to return to automatic mode.
Apply the TLP profile for AC power and enter manual mode:
sudo tlp ac
Apply the TLP profile for battery power and enter manual mode:
sudo tlp bat
USB Autosuspend
Apply autosuspend mode for all attached USB devices except those excluded by default or via configuration:
sudo tlp usb
Optical Drive
Power off optical drive in MediaBay/Ultrabay:
sudo tlp bayoff
Hints:
Re-power the drive by releasing and reinserting the drive slot/Ultrabay eject lever; on newer models push the media eject button
Devices other than optical drives – in particular hard disk drives – are not affected by this command
Battery Care
Important
The availability of battery care, all of its individual features and the possible charge threshold values always depend on laptop vendor or brand, Linux kernel version and TLP version - consult Battery Care Vendor Specifics for details.
For further advice please visit the FAQ: Battery Care.
Note
For laptops with two batteries, the secondary battery must be specified as a command parameter in order to select it. In many cases the main battery will be BAT0, the secondary battery BAT1. When in doubt, check the output of tlp-stat -b, which lists all batteries.
Change battery charge thresholds temporarily
sudo tlp setcharge [<start threshold> <stop threshold>] [<battery>]
Changes the charge thresholds for the battery to the given values.
Configured thresholds will be restored at the next boot or by using tlp setcharge again but without the threshold arguments.
Example:
sudo tlp setcharge 70 90 BAT0
Applies thresholds of 70/90% to battery BAT0.
Note
tlp setcharge changes the charge thresholds only temporarily. To make the change permanent, you must activate or change the related settings in the config file. Refer to Battery Care.
Charge battery to full capacity
sudo tlp fullcharge [<battery>]
This is done by applying vendor presets to the charge thresholds temporarily. Configured thresholds will be restored at the next boot or by using tlp setcharge without the threshold arguments.
Hint: after setting the thresholds the command terminates; it does not wait for the charge to complete.
Example:
sudo tlp fullcharge BAT0
Charges battery BAT0 to full capacity.
Charge battery to the stop charge threshold once
sudo tlp chargeonce [<battery>]
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.
Hint: after setting he thresholds the command terminates; it does not wait for the charge to complete.
Example:
sudo tlp chargeonce BAT0
Charges battery BAT0 up to the stop threshold.
Force a complete/partial discharge of the battery while on AC power
Version 1.8 and newer
sudo tlp discharge [<battery>] [<level>]
Version 1.7 and older
sudo tlp discharge [<battery>]
The selected battery is discharged to target level (in %). If none is specified the battery is fully discharged. The command continously shows remaining capacity and estimated discharge time. Discharging may be stopped at any time with Control-C.
The command needs the charger plugged in.
If the target level is below the start threshold, the battery will begin recharging once the command ends.
ThinkPads with two batteries: the battery controller can only handle one battery at a time; while discharging one battery with this command the other battery can neither be charged nor discharged.
When encountering problems, see the FAQ.
Caution
Normal use of the laptop is possible during the discharge process; it does not suddenly power off when the battery is empty. However, some versions of UPower falsely trigger a system shutdown when the battery discharge reaches 2%; see the FAQ.
Example:
sudo tlp discharge BAT0 50
Discharges battery BAT0 down to 50%.
Perform a battery recalibration while on AC power
sudo tlp recalibrate [<battery>]
First, vendor presets are applied to the charge thresholds. Then, the selected battery is discharged completely. The command continously shows remaining capacity and estimated discharge time. Discharging may be stopped at any time with Control-C.
The command needs the charger plugged in.
As soon as the battery is empty, he command ends and recharging begins; it does not wait for the recharge to complete.
Configured thresholds will be restored at the next boot or by using tlp setcharge without the threshold arguments.
Important: to complete the recalibration process, let the battery charge to 100 % subsequently; you may power off but not remove the charger.
ThinkPads with two batteries: the battery controller can only handle one battery at a time; while discharging one battery with this command the other battery can neither be charged nor discharged. * When encountering problems, see the FAQ.
Caution
Normal use of the laptop is possible during the discharge process; it does not suddenly power off when the battery is empty. However, some versions of UPower falsely trigger a system shutdown when the battery discharge reaches 2%; see the FAQ.
Example:
sudo tlp recalibrate BAT0
Recalibrates battery BAT0.
Hints:
Recalibration forces the battery pack to update the energy_full or charge_full information shown by tlp-stat -b
Recalibration does not repair defective or worn out batteries
Disk IDs
tlp diskid
Shows disk ids for configured drives.
Version
Version 1.7 and newer
tlp --version
Shows the installed version.