Input Devices

Pinnacle provides ways to manage input devices, like keyboards, mice, touchpads, and more.

Device handles

Input devices are exposed to you through device handles. Handles can be retrieved by requesting all of them manually, and they are also provided through the "device added" signal and for_each_device function.

local devices = require("pinnacle.input.libinput").get_devices()

Device handles expose ways to set various libinput settings as well as getters for device information, like name and vendor ID.

Device setup

You will probably want to set device settings on both startup and whenever a new device is connected. The API provides the for_each_device function, which allows you to supply a function that operates on all currently connected input devices as well as all newly connected ones.

require("pinnacle.input.libinput").for_each_device(function(device)
    if device:device_type() == "touchpad" then
        device:set_natural_scroll(true)
        device:set_tap(true)
    end
    -- Do other stuff with the device
end)

Read the corresponding API reference to see all possible settings.