libinput-a...-slot-delta(1)

💖 libinput-analyze-per-slot-delta 💖

okay bestie, so this one is a page from the General Commands Manual — it's libinput-analyze-per-slot-delta, and yes that name is a whole mouthful, we're just gonna vibe with it. 🫶

---

✨ NAME ✨

libinput-analyze-per-slot-delta — analyze the per-event delta movement for touch slots

---

🌸 SYNOPSIS 🌸

libinput analyze per-slot-delta [--help] [options] recording.yml

---

🦋 DESCRIPTION 🦋

The libinput analyze per-slot-delta tool looks at a recording you made with libinput record and prints out the delta movement per touch slot. that's it, that's the whole job. 💅

⚠️ lowkey important: this is a debugging tool only. its output may change at any time. do not rely on the output. like, at all. no cap. 😭

---

🎀 OPTIONS 🎀

• --help — prints help, iconic, we love a supportive flag 🫶
• --ignore-below=<units or mm> — ignore any movement that's below the threshold you give it. the threshold is in mm if --use-mm is selected, otherwise it's in device units. pick your fighter. ✨
• --show-distance — also show the distance relative to the initial position of the current touch. that distance is in mm if --use-mm is selected, otherwise device units. ✨
• --threshold=<units or mm> — colors any movement above this threshold in red. threshold is in mm if --use-mm is selected, otherwise device units. it's giving dramatic highlight. 🔥
• --use-mm — print data in mm instead of device units
• --use-st — use the single-touch ABS_X/ABS_Y instead of the multitouch axes
• --use-absolute — print absolute coordinates, not deltas

---

🌈 OUTPUT 🌈

here's an example output for a single finger touch on a touchpad that supports two slots. this one was made with the --use-mm flag. 💖

 0.000000   +0ms TOU:     ++++++     |  ************* |
 0.021900  +21ms TOU: →↘ +1.10/+0.14 |  ************* |
 0.033468  +11ms TOU: →↘ +1.15/+0.19 |  ************* |
 0.043856  +10ms TOU: →↘ +1.76/+0.22 |  ************* |
 0.053237   +9ms TOU: →↘ +2.20/+0.19 |  ************* |

the ++++++ entry means a finger has been put down, and ------ means the finger has lifted. the left-most column is the absolute timestamp in seconds.microseconds, followed by the relative time of the event compared to the previous event. ⏱️

the word TOU in this example represents BTN_TOUCH — and similar abbreviations exist for BTN_TOOL_DOUBLETAP, BTN_TOOL_TRIPLETAP, BTN_TOOL_QUADTAP, and BTN_TOOL_QUINTTAP. so many tools, so little time. 🙈

the arrows show the approximate direction on a 16-point compass — in this example, EastSouthEast. 🧭

each multitouch slot the hardware supports gets its own column, and that column shows asterisks ******** when no finger is down for that slot. where the column shows spaces only, a finger is down but no data is currently available. the way that's such a mood. 💀

in the example above, the third event occurs ~33ms into the recording, is 11ms after the previous event, and has an east south-east direction. the movement for this event was x: 1.15 and y: 0.19 mm. a second finger is not currently down. ⭐

---

👑 LIBINPUT 👑

part of the libinput(1) suite ✨

---

and that's the whole page bestie, you ate it up. this little slice of the General Commands Manual is signed off as libinput-a...-slot-delta(1) — go forth and analyze those slots, main character. 🎀💜🦋