xlibinput_calibrator(8)

💖 NAME 💖

okay so bestie, welcome to xlibinput_calibrator(8) — from the General Commands Manual — the main character whose whole job is to calibrate a X11 touch screen device. that's the assignment, and she ate 💅✨

🎀 SYNOPSIS 🎀

xlibinput_calibrator [--output-file-x11-config=<filename>] [--dont-save]
                     [--output-file-xinput-cmd=<filename>] [--verbose]
                     [--threshold-misclick=<nn>] [--matrix=_x1,x2..x9_]
                     [--threshold-doubleclick=<nn>] [--show-matrix]
                     [--device-name=<devname>|-device-id=<device-id>]
                     [--show-x11-config] [--show-xinput-cmd]
                     [--monitor-number=<nr>] [-display=<display>]
xlibinput_calibrator --list-devices

🦋 DESCRIPTION 🦋

xlibinout_calibrator(8) calibrates a touch screen by setting the so-called libinput matrix calibration using the xinput interfaces. yes, the original DESCRIPTION spells it with an extra o — xlibinout_calibrator(8) — not me preserving the lore, but also literally me preserving the lore 😭

The possible outcomes of this command are: set a new X11 configuration; create a new configuration file for X11; show the xinput command option to set the new matrix calibration. three outcomes, three vibes ✨

💅 OPTIONS 💅

• --output-file-x11-config=<filename> — sets the filename where the X11 configuration will be saved. Implies --show-x11-config.
• --output-file-xinput-cmd=<filename> — sets the filename where the xinput command will be saved. Implies --show-xinput-cmd.
• --threshold-misclick=<nn> — sets the threshold for accepting or rejecting a click. The four clicks have to be in the corners of a rectangle. The value you pass is the maximum allowable distance between the click and the ideal point. If the value is 0 (the default), the check is not performed.
• --threshold-doubleclick=<nn> — sets the threshold for accepting or rejecting a click. It sets the minimum distance between clicks to accept them. If the value is 0, the check is not performed. Default value 1.
• --device-name=<devname>|--device-id=<device-id> — xlibinput_calibrator(8) selects the device to operate on automatically. If for some reason that's not possible (multiple devices are available, for example), you can explicitly select the device with --device-id=... or --device-name=.... the former takes precedence.
• --matrix-name=<matrix-name> — sets the name of the matrix used for the calibration.
• --show-x11-config — shows the X11 file configuration with the new matrix_calibration.
• --display=<display> — sets the X11 display.
• --show-xinput-cmd — shows the xinput(1) command for the matrix_calibration.
• --show-matrix — shows the final matrix when the program ends.
• --verbose — be verbose.
• --dont-save — don't save the setting in X11 when the program ends.
• --matrix=<x1,x2..x9> — sets the initial matrix before doing the calibration. By default, xlibinput_calibrator(8) sets the calibration matrix to the identity (i.e. all 1 in the diagonal). With this option it's possible to set another matrix. Note that if something goes wrong or the calibration fails, the original matrix is set in X11. iykyk, that's your safety net 🫶
• --monitor-number=<nr> — sets the monitor to display the window. If <nr> is equal to all, the window will span all the monitors area. Use xrandr --listmonitors to get the <nr> associated to the monitor.
• --list-devices — shows all the available devices with their ID.

🌈 AUTHOR 🌈

Goffredo Baroncelli <kreijack@inwind.it> — the icon behind the icon 💖

okay that's the whole page, bestie. this cutie comes from the xlibinput_calibrator(8) manual (that's the source, fr fr), dated 01 January 1980 🎀✨ periodt.