tlp - Man Page

• Apply settings (according to the actual power source): sudo tlp start
• Apply battery settings (ignoring the actual power source): sudo tlp bat
• Apply AC settings (ignoring the actual power source): sudo tlp ac

tldr.sh

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

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

start

Start tlp and apply power saving profile for the actual power source. Also use to apply a changed configuration or to leave manual mode.

bat

Apply battery 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

Alias for bat.

ac

Apply AC 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

Alias for ac.

usb

Enable autosuspend for all USB devices except those excluded by default or via 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]

Change battery charge thresholds 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 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 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 a complete discharge of the battery while on AC power.

recalibrate [BAT0|BAT1] (ThinkPads only)

Perform a battery recalibration while on AC power: 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 configured drives.

-- CONFIG_PARAM=value ...

Append configuration parameters to a command. These temporarily override the system configuration during execution of that command only and are not kept afterwards. Disclaimer: this feature exists for the sole purpose of test automation during TLP's development. It is provided as is and there is no support whatsoever.

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

BAT0 - Main or internal battery

BAT1 - Secondary or replaceable battery

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

/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.

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

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

Project homepage:

Charge thresholds:

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

bluetooth(1), nfc(1), run-on-ac(1), run-on-bat(1), tlp-rdw(8), tlp_selinux(8), tlp.service(8), tlp-stat(8), wifi(1), wwan(1).