POWERPROFILESCTL(1)

📦
version 0.30 · 10 versions
, in ubuntu resolute, ubuntu stonking

💖 POWERPROFILESCTL 💖

okay so bestie, welcome to POWERPROFILESCTL(1) — the Power Profiles Daemon Control Program page, straight out of section 1 of your manual. it's the little command line baddie that lets you boss your power profiles around. no cap. 💅

✨ NAME ✨

powerprofilesctl — Command line utility to control Power Profiles Daemon 🦋

that's literally it. that's the whole job. and she does it flawlessly.

🌈 SYNOPSIS 🌈

powerprofilesctl [-h] {list,list-holds,list-actions,get,set,configure-
action,configure-battery-aware,query-battery-aware,launch,version} ...

so you run the command, optionally throw a -h in there for help, and then you pick one of these ten subcommands. ten. count 'em. she's got range. 💜

👑 POSITIONAL ARGUMENTS 👑

🌸 powerprofilesctl list 🌸

List available power profiles ✨ like window shopping but for power modes.

usage:

powerprofilesctl list [-h]

🎀 powerprofilesctl list-holds 🎀

List current power profile holds — shows you who's currently got a grip on your profile. lowkey nosy, highkey useful. 👀

usage:

powerprofilesctl list-holds [-h]

🦋 powerprofilesctl list-actions 🦋

List available power profile actions — everything your profiles are allowed to do, served on a platter. 🍓

usage:

powerprofilesctl list-actions [-h]

⭐ powerprofilesctl get ⭐

Print the currently active power profile — one line, tells you what vibe your machine is currently in.

usage:

powerprofilesctl get [-h]

🔥 powerprofilesctl set 🔥

Set the currently active power profile — this is the main character command fr fr. she changes the vibe. 👑

usage:

powerprofilesctl set [-h] {}

arguments:

  • {} — Profile to use for set command

💜 powerprofilesctl configure-action 💜

Configure the action to be taken for the profile — you're telling a profile what it's allowed to do when it grows up.

usage:

powerprofilesctl configure-action [-h] [--enable] [--disable] action

arguments:

  • action — action to change for configure-action

options:

  • --enable — enable action
  • --disable — disable action

🫶 powerprofilesctl configure-battery-aware 🫶

Turn on or off dynamic changes from battery level or power adapter — the machine gets to read the room (aka your battery percentage and whether you're plugged in) and adjust accordingly. it's giving self-aware, affectionately. 🔋

usage:

powerprofilesctl configure-battery-aware [-h] [--enable] [--disable]

options:

  • --enable — enable battery aware
  • --disable — disable battery aware

🔍 powerprofilesctl query-battery-aware 🔍

Query if dynamic changes from battery level or power adapter are enabled — a yes/no wellness check on the battery-aware setting. no judgement, just facts. 💅

usage:

powerprofilesctl query-battery-aware [-h]

🚀 powerprofilesctl launch 🚀

Launch a command while holding a power profile

usage:

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

so the whole thing here: Launch the command while holding a power profile, either performance, or power-saver. and listen — By default, the profile hold is for the performance profile, but it might not be available on all systems. so don't come for me if your machine doesn't do it, okay? See the list command for a list of available profiles. periodt.

arguments:

  • arguments — Command to launch

options:

  • --profile PROFILE, -p PROFILE — Profile to use for launch command
  • --reason REASON, -r REASON — Reason to use for launch command
  • --appid APPID, -i APPID — AppId to use for launch command</paach>
ngl those three flags are genuinely iconic. you're not just running a program, you're running it with lore — a profile, a reason, and an app id. main character energy. ✨

💫 powerprofilesctl version 💫

Print version information and exit — she tells you who she is and then she dips. 🦋

usage:

powerprofilesctl version [-h]

💬 COMMENTS 💬

Use powerprofilesctl COMMAND --help to get detailed help for individual commands. (yep, the original put that whole thing in curly quotes, and honestly? cute.)

so if any single subcommand is giving you question marks, just ask her directly. she'll explain herself. 🫶

🎀 AUTHOR 🎀

  • Bastien Nocera
  • Mario Limonciello

the girlies (gender neutral) who built her. legends only. 👑

🌈 DISTRIBUTION 🌈

The latest version of power-profiles-daemon may be downloaded from:

https://gitlab.freedesktop.org/upower/power-profiles-daemon

go get her, bestie. 💖

and that's the whole page!! power-profiles-daemon 0.30, dated 2025-11-05 — that's the version and the vibe check stamp at the bottom, so now you know exactly which era of this manual you just read. slay, go set some profiles, and remember: performance might not exist on your system, so check list first. mwah. 💅✨🌸

📦 where this page comes from