.TH POWERPROFILESCTL "1" "2025\-02\-18" "power\-profiles\-daemon 0.30" "Power Profiles Daemon Control Program"
.SH NAME
powerprofilesctl \- Command line utility to control Power Profiles Daemon
.SH SYNOPSIS
.B powerprofilesctl
[-h] {list,list-holds,list-actions,get,set,configure-action,configure-battery-aware,query-battery-aware,launch,version} ...

.SH
POSITIONAL ARGUMENTS
.SS \fBpowerprofilesctl list\fR
List available power profiles

usage: powerprofilesctl list [\-h]
.SS \fBpowerprofilesctl list\-holds\fR
List current power profile holds

usage: powerprofilesctl list\-holds [\-h]
.SS \fBpowerprofilesctl list\-actions\fR
List available power profile actions

usage: powerprofilesctl list\-actions [\-h]
.SS \fBpowerprofilesctl get\fR
Print the currently active power profile

usage: powerprofilesctl get [\-h]
.SS \fBpowerprofilesctl set\fR
Set the currently active power profile

usage: powerprofilesctl set [\-h] {}

arguments:
.RS 7
.TP
\fB{}\fR
Profile to use for set command
.RE

.SS \fBpowerprofilesctl configure\-action\fR
Configure the action to be taken for the profile

usage: powerprofilesctl configure\-action [\-h] [\-\-enable] [\-\-disable] action

arguments:
.RS 7
.TP
\fBaction\fR
action to change for configure\-action
.RE


options:
.RS 7
.TP
\fB\-\-enable\fR
enable action

.TP
\fB\-\-disable\fR
disable action
.RE

.SS \fBpowerprofilesctl configure\-battery\-aware\fR
Turn on or off dynamic changes from battery level or power adapter

usage: powerprofilesctl configure\-battery\-aware [\-h] [\-\-enable] [\-\-disable]

options:
.RS 7
.TP
\fB\-\-enable\fR
enable battery aware

.TP
\fB\-\-disable\fR
disable battery aware
.RE

.SS \fBpowerprofilesctl query\-battery\-aware\fR
Query if dynamic changes from battery level or power adapter are enabled

usage: powerprofilesctl query\-battery\-aware [\-h]
.SS \fBpowerprofilesctl launch\fR
Launch a command while holding a power profile

usage: powerprofilesctl launch [\-h] [\-\-profile PROFILE] [\-\-reason REASON]
                               [\-\-appid APPID]
                               [arguments ...]

Launch the command while holding a power profile, either performance, or power\-saver. By default, the profile hold is for the performance profile, but it might not be available on all systems. See the list command for a list of available profiles.

arguments:
.RS 7
.TP
\fBarguments\fR
Command to launch
.RE


options:
.RS 7
.TP
\fB\-\-profile\fR \fI\,PROFILE\/\fR, \fB\-p\fR \fI\,PROFILE\/\fR
Profile to use for launch command

.TP
\fB\-\-reason\fR \fI\,REASON\/\fR, \fB\-r\fR \fI\,REASON\/\fR
Reason to use for launch command

.TP
\fB\-\-appid\fR \fI\,APPID\/\fR, \fB\-i\fR \fI\,APPID\/\fR
AppId to use for launch command
.RE

.SS \fBpowerprofilesctl version\fR
Print version information and exit

usage: powerprofilesctl version [\-h]

.SH COMMENTS
Use “powerprofilesctl COMMAND \-\-help” to get detailed help for individual
commands

.SH AUTHOR
.nf
Bastien Nocera
.fi
.nf
Mario Limonciello
.fi

.SH DISTRIBUTION
The latest version of power\-profiles\-daemon may be downloaded from
.UR https://gitlab.freedesktop.org/upower/power\-profiles\-daemon
.UE