libinput/plugins/meson.build

plugins = [
	'10-example.lua',
	'10-dwt.lua',
	'10-logitech-mx-master-horiz-scroll.lua',
	'10-pointer-go-faster.lua',
	'10-pointer-go-slower.lua',
	'10-delay-motion.lua',
	'10-disable-feature.lua',
	'10-copilot-key-override.lua',
	'10-wheel-to-button.lua',
	'10-tablet-mouse-control.lua',
]

fs = import('fs')
foreach plugin : plugins
	fs.copyfile(plugin)
endforeach
plugins: add support for lua plugins to change evdev event streams This patch adds support for Lua scripts to modify evdev devices and event frames before libinput sees those events. Plugins in Lua are sandboxed and restricted in what they can do: no IO, no network, not much of anything else. A plugin is notified about a new device before libinput handles it and it can thus modify that device (changes are passed through to our libevdev context). A plugin can then also connect an evdev frame handler which gives it access to the evdev frames before libinput processes them. The example plugin included shows how to swap left/right mouse buttons: libinput:register({1}) function frame(device, frame) for _, v in ipairs(frame.events) do if v.usage == evdev.BTN_RIGHT then v.usage = evdev.BTN_LEFT elseif v.usage == evdev.BTN_LEFT then v.usage = evdev.BTN_RIGHT end end return frame end function device_new(plugin, device) local usages = device:usages() if usages[evdev.BTN_LEFT] and usages[evdev.BTN_RIGHT] then device:connect("evdev-frame", frame) end end libinput:connect("new-evdev-device", device_new) A few other example plugins are included in this patch Part-of: <https://gitlab.freedesktop.org/libinput/libinput/-/merge_requests/1192> 2025-04-22 10:25:55 +10:00			`plugins = [`
			`'10-example.lua',`
			`'10-dwt.lua',`
			`'10-logitech-mx-master-horiz-scroll.lua',`
			`'10-pointer-go-faster.lua',`
			`'10-pointer-go-slower.lua',`
			`'10-delay-motion.lua',`
lua: implement support for disabling of features Because our lua hooks don't expose the device-added callback we need to cache any calls to disable a feature and then apply it quietly when the device is actually added. Any other call can go straight through. Part-of: <https://gitlab.freedesktop.org/libinput/libinput/-/merge_requests/1249> 2025-06-25 15:10:03 +10:00			`'10-disable-feature.lua',`
plugins: add an example plugin on how to reconfigure the Copilot key As Microsoft has decreed, that key sends LEFTMETA + LEFTSHIFT + F23 (usually across multiple frames) and the then the same in reverse when released. xkeyboard-config 2.44 maps this sequence by default to XF86Assistant but for the use-cases where this does not work reshuffling the whole event sequence is the best approach and that can easily be done with a plugin. Note that this is the minimum effort plugin - it works for one keyboard at at time (duplicate the plugin if two keyboards are needed, or remove the vid/pid check) and it does not intercept the meta/shift key presses and delay them, it simply releases them on F23 and then replays the new sequence. Good enough for an example plugin. Example sequence produces shift + a on press and releases a + shift on release. Holding the key will thus produce AAAAAAAAA which is an excellent summary of how this key was designed. Part-of: <https://gitlab.freedesktop.org/libinput/libinput/-/merge_requests/1352> 2025-10-30 13:46:27 +10:00			`'10-copilot-key-override.lua',`
plugins: add an example for using a wheel to trigger button scrolling See https://gitlab.freedesktop.org/libinput/libinput/-/issues/1206 Part-of: <https://gitlab.freedesktop.org/libinput/libinput/-/merge_requests/1356> 2025-11-03 16:39:35 +10:00			`'10-wheel-to-button.lua',`
plugin: add an example for controlling a mouse with a tablet This plugin controls a mouse/pointer from a tablet device. This effectively hides stylus interactions and sends pointer events instead. In other words: mouse emulation for tablets, implemented by (remote) controlling a mouse device. This allows using a tablet stylus as a mouse replacement without tablet limitations from compositors or clients. Note that axis usually needed for drawing (like pressure, tilt or distance) are no longer emitted when this plugin is active and a mouse is connected. When no mouse is connected, this plugin doesn't change tablet events, thus the stylus works like a normal stylus. Follow up from https://gitlab.freedesktop.org/libinput/libinput/-/issues/1195 Part-of: <https://gitlab.freedesktop.org/libinput/libinput/-/merge_requests/1412> 2026-01-18 10:49:30 +01:00			`'10-tablet-mouse-control.lua',`
plugins: add support for lua plugins to change evdev event streams This patch adds support for Lua scripts to modify evdev devices and event frames before libinput sees those events. Plugins in Lua are sandboxed and restricted in what they can do: no IO, no network, not much of anything else. A plugin is notified about a new device before libinput handles it and it can thus modify that device (changes are passed through to our libevdev context). A plugin can then also connect an evdev frame handler which gives it access to the evdev frames before libinput processes them. The example plugin included shows how to swap left/right mouse buttons: libinput:register({1}) function frame(device, frame) for _, v in ipairs(frame.events) do if v.usage == evdev.BTN_RIGHT then v.usage = evdev.BTN_LEFT elseif v.usage == evdev.BTN_LEFT then v.usage = evdev.BTN_RIGHT end end return frame end function device_new(plugin, device) local usages = device:usages() if usages[evdev.BTN_LEFT] and usages[evdev.BTN_RIGHT] then device:connect("evdev-frame", frame) end end libinput:connect("new-evdev-device", device_new) A few other example plugins are included in this patch Part-of: <https://gitlab.freedesktop.org/libinput/libinput/-/merge_requests/1192> 2025-04-22 10:25:55 +10:00			`]`

			`fs = import('fs')`
			`foreach plugin : plugins`
			`fs.copyfile(plugin)`
			`endforeach`