Volume & brightness: states & gestures

The volume and brightness blanks read the current level into your text, then adjust the real device from the same line. This page lists every state and every key. Verified against a running host.

Script blanks: values read from your machine

🔊 volume

Labelled system volume. Each press moves it 6 percentage points, between 0% and 100%. Backed by volume-blank.sh get|set (Windows / macOS / PipeWire / PulseAudio / ALSA).

🔆 brightness

Labelled screen brightness. Each press moves it 10 percentage points, between 0% and 100%. Same script shape, same gestures, so everything here applies to both.

Reading and setting the level

Include a number and it sets the level; leave it out and it just reads the current one. Either way you end up with the value in your text and the cursor on it.

You typeModeYour text becomesWhat happens
volume _GETvolume 26%reads the current level and writes it in
volume 40 _SETvolume 40%turns the volume to 40%, writes it in
volume 60 _SETvolume 60%turns the volume to 60%

The word volume stays in your text so the number still makes sense on its own later (volume 40%, not a stray 40%).

The note: what you see on the value

Format: the emoji, the label, then the hint in brackets. The label persists, marking the value as adjustable; the hint teaches the gesture and is dropped after your first adjustment.

First encounter

volume 26%↳ 🔊 system volume (ctrl+alt+up/down to adjust)

Label + the teaching hint.

After your first adjust

volume 32%↳ 🔊 system volume

Hint gone, label stays: still visibly live.

Gestures: what moves the value

Put the cursor on the number. Every press changes the real device and updates the number, never going below 0% or above 100%.

KeyDoesAt the edges
Ctrl+Alt+↑raises it one step (6% for volume, 10% for brightness)stops at 100%
Ctrl+Alt+↓lowers it by the same stepstops at 0% (muted / screen dark)
_raises it one step; the single-key alternative to the chordclimbs to 100% and stays there; the _ is never typed into your text

_ is the one-direction quick nudge (up); use Ctrl+Alt+↓ when you need to come back down. Both write straight to the device.

The value states

One continuous 0–100 range. The number in your text is the device's real value; the bars below are illustrations of it.

Normal: anywhere between

32%
moves up or down a step at a time
76%

Top edge: 100%

100%
the maximum: pressing up again does nothing (it never wraps round to 0%)
volume 100%↳ 🔊 system volume

Bottom edge: 0%

0%
silent / screen dark: pressing down again does nothing
volume 0%↳ 🔊 system volume

Worked example: climbing with the underscore

Verified live. volume _ reads the current level (26%), then each bare _ adds 6 points until it reaches 100% and stops.

Type volume _reads 26%
volume 26%↳ 🔊 system volume (ctrl+alt+up/down to adjust)
Press _26 + 6 = 32% · louder
volume 32%↳ 🔊 system volume
Press _32 + 6 = 38%
volume 38%↳ 🔊 system volume
Keep pressing _at 98%, +6 would be 104%, so it stops at 100%
volume 100%↳ 🔊 system volume
Press _ againnothing changes, and no _ is typed
volume 100%↳ 🔊 system volume
Press Ctrl+Alt+↓100 − 6 = 94% · quieter
volume 94%↳ 🔊 system volume
It stops at the top, it does not wrap. Holding _ down at 100% keeps it at 100%; it never wraps to 0%, so one extra press cannot silently mute you. To come back down, use Ctrl+Alt+↓.