libinput-m...-touch-size(1)

✨ NAME ✨

libinput-measure-touch-size — bestie, this thing measures the touch size and orientation of devices 🫶

(also hi, you're reading page libinput-m...-touch-size(1) from the General Commands Manual, and she's iconic)

🌸 SYNOPSIS 🌸

libinput measure touch-size [--help] [options] [/dev/input/event0]

🦋 DESCRIPTION 🦋

okay so. The libinput measure touch-size tool measures the size and orientation of a touch, exactly as the kernel hands it over. no cap.

This is an interactive tool, and the way that it works is: when you run it, it literally prompts you to go interact with the touch device 💅. Then on termination — yes, when it's done — it prints a summary of the values it saw. And the whole point? This data should be attached to any touch-size-related bug report. Like, if you're filing a touch-size bug, this summary is your little gift to the maintainers 🎀

⚠️ bestie, listen. This is a debugging tool only, and its output may change at any time. Do not rely on the output. periodt.

Also, this tool usually needs to be run as root so it can actually get at the /dev/input/eventX nodes. it's giving permission issues otherwise, fr fr 😭

💅 OPTIONS 💅

So if you give it a device node, this tool opens that device node. Otherwise? It goes hunting and searches for the first node that looks like a touch-capable device, and uses that one. main character energy, honestly 👑

• --help — Print help. that's it, that's the whole vibe ✨
• --touch-thresholds="down:up" — Set the logical touch size thresholds to down and up, respectively. Here's the tea: when a touch exceeds the size in down, it is considered logically down. And if a touch is logically down and then goes below the size in up, it's considered logically up. The thresholds have to be in device-specific pressure values, and it is required that down >= up. (yes, required. down can be equal to up, but it cannot be smaller, don't try it 🙈)
• --palm-threshold=N — Assume a palm threshold of N. The threshold has to be in device-specific pressure values too. palms stay losing 🖐️💀

🫶 and if the touch-thresholds or the palm-threshold are not provided, this tool uses the thresholds provided by the device quirks (if any) or the built-in defaults. so like, it's got a fallback. she's prepared.

👑 LIBINPUT 👑

Part of the libinput(1) suite. yep, she runs with a whole crew 🌈

okay that's the whole page bestie!! footer says libinput-m...-touch-size(1), straight out of the General Commands Manual, and it's literally the same title as the top because the manpage said so. no date on this one, we're keeping it mysterious 😌 💖