BRIGHTNESSCTL(1)

🌟 BRIGHTNESSCTL(1) — the brightnessctl manual, but make it cute 🌟

okay bestie, listen. this is brightnessctl — the little command-line cutie that reads and controls your device brightness. your screen? your keyboard backlight? she's got range. let's go 💅

---

✨ NAME ✨

brightnessctl — read and control device brightness 🦋

---

✨ SYNOPSIS ✨

brightnessctl [options] [operation] [value...]

that's it. that's the whole shape of it. options first, then the operation, then whatever value you're feeding her. slay 🎀

---

✨ OPTIONS ✨

• -h, --help — prints this help. the "girl just tell me what to do" option 🫶
• -l, --list — lists every device that has brightness controls available. a little roster of your faves ✨
• -q, --quiet — suppresses output. she's silent, she's mysterious, she's doing it anyway 💜
• -p, --pretend — does not perform write operations. purely a dress rehearsal, no actual changes 🔥
• -m, --machine-readable — produces machine-readable output. for when you need it parsed, not admired 🤖
• -n, --min-value=VALUE — sets the minimum brightness used when you're working with delta values. defaults to 1.
• -e, --exponent=K — changes the percentage scaling curve from linear (the default) to exponential. default exponent is 4.

the percentage equation, verbatim, no cap:

% = [VALUE]^[K] * [MAX] * 100^-[K]

the exponential curve may make the adjustments perceptually equal — i.e. it actually feels even to your eyeballs instead of lying to you 💀

• -s, --save — saves state in a temporary file. little snapshot, little memory, we love to see it 📸
• -r, --restore — restores the previously-saved state. she remembers 🥺
• -d, --device=DEVICE — specify the device name. can be a wildcard, so go feral with it 🌈
• -c, --class=CLASS — specify the device class.
• -v, --version — prints the version and exits. mic drop, she's out 👑

---

✨ OPERATIONS ✨

• i, info — get device info. the tea ☕
• g, get — get the current brightness of the device.
• m, max — get the maximum brightness of the device. her ceiling, her limit, her final form 💅
• s, set VALUE — set the brightness of the device. this is the main character one 👑

✨ VALUES ✨

so for the set command you can hand her a VALUE in absolute form or relative form, and as either a plain value or a delta from the current value. the range?? unmatched. here's the receipts:

brightnessctl set 500

sets brightness to 500.

brightnessctl set 50%

sets brightness to 50% of the maximum.

brightnessctl set 50-

subtracts 50 from the current brightness.

brightnessctl set +10

adds 10 to the current brightness.

brightnessctl set 50%-

subtracts 50% of the maximum from the current brightness.

brightnessctl set +10%

adds 10% of the maximum to the current brightness.

see how the + and - are doing the whole personality of the command?? absolute vs relative, percentage vs raw. she contains multitudes 🦋

---

✨ AUTHORS ✨

maintained by Mykyta Holubakha, who is assisted by other open source contributors 🫶 for more info about brightnessctl development, come through:

https://github.com/Hummer12007/brightnessctl

---

ngl, don't forget the -p flag exists — if you're just testing a vibe, pretending means no writes actually happen. safety first, bestie 💖

---

and that's the whole page, fr fr. this was brightnessctl, from the brightnessctl manual, dated 24th Jan 2018 — yes she's an elder but she's still iconic and she ate 💅🌸 bye bestie, go brighten something 🎀✨