TS_CALIBRATE(1)

✨ TS_CALIBRATE(1) ✨

okay bestie, welcome to ts_calibrate, a page straight out of tslib 💖 this is the whole manual, no skips, no gatekeeping 🫶

---

🌸 NAME 🌸

ts_calibrate — a test program to calibrate a touch screen used by tslib. yes that's literally its whole job and it ate 💅

---

🎀 SYNOPSIS 🎀

ts_calibrate

no args needed, it just goes ✨

---

🦋 DESCRIPTION 🦋

ts_calibrate is here to manually configure tslib's linear filter plugin. it draws crosshairs onto the framebuffer that you (yes, you, the human) have to touch, and it records the expected vs. actual touch contact positions — those are what's needed to apply the filter and give you the desired touch user experience. she's doing the math so your taps land where you meant them to 😭👑

it uses the TSLIB_CALIBFILE environment variable to store its values. iconic behavior, tbh.

• -r, --rotate [value] — rotate the screen. value is 0 for 0 degree, 1 for 90 degrees (CW), 2 for 180 degrees (upside down) and 3 for 270 degrees (CCW). this value gets added to the calibration config file TSLIB_CALIBFILE and picked up from the linear filter module from there. it can be changed by a linear module parameter. so yeah, you can flip the whole vibe later 🌀
• -t, --min_interval — the time in milliseconds that has to pass before a crosshair is pressed by the user. this is lowkey useful to avoid insanely fast or accidentally wrong taps, which would give you an inaccurate calibration. Default: 0.
• -c, --validate — validate the calibration. make sure the linear module is configured in ts.conf so that the current calibration is actually applied. in this mode, crosses are displayed at random locations on screen and touches are evaluated against their positions. and in this mode, the --loops and --boundary options are available 👀
• -b, --boundary — validation boundary in pixels. available only when --validate is used. this defines how strict the validation should be. it's the distance that an evaluated touch input is allowed to be apart from a cross to still pass the validation. if this boundary is crossed, validation fails 💀 Default: 10.
• -o, --border — number of pixels to keep away from the screen border. available only when --validate is used. Default: 0.
• -l, --loops — number of loops in validation mode. available only when --validate is used. this defines how many crosses should be touched and evaluated. Default: 3.

---

🧚 ENVIRONMENT VARIABLES 🧚

see ts.conf (5). that's the whole section, she's mysterious like that 🙈

---

🌈 SEE ALSO 🌈

• ts.conf (5)
• ts_test (1)
• ts_uinput (1)

---

and that's the tea, bestie 🍓 this was page TS_CALIBRATE(1) from tslib — go calibrate something and slay ✨💅👑