games-on-whales / inputtino

A virtual input library: supports mouse, keyboard, joypad, trackpad and more

inputtino

An easy to use virtual input library for Linux built on top of uinput and evdev.
Supports:

• Keyboard
• Mouse
• Touchscreen
• Trackpad
• Pen tablet
• Joypad
  • Correctly emulates Xbox, PS5 or Nintendo joypads
  • Supports callbacks on Rumble events
  • Gyro, Acceleration and Touchpad support (using UHID, see rationale here)

Use the REST API

WIP: A simple JSON REST API to consume this library

docker run --init --name inputtino -p 8080:8080 -v /dev/input:/dev/input:rw --device /dev/uinput ghcr.io/games-on-whales/inputtino:stable

Include in a C++ project

If using Cmake it's as simple as

FetchContent_Declare(
        inputtino
        GIT_REPOSITORY https://github.com/games-on-whales/inputtino.git
        GIT_TAG <GIT_SHA_OR_TAG>)
FetchContent_MakeAvailable(inputtino)
target_link_libraries(<your_project_name> PUBLIC inputtino::libinputtino)

Example usage

#include <inputtino/input.hpp>

auto joypad = Joypad::create(Joypad::PS, Joypad::RUMBLE | Joypad::ANALOG_TRIGGERS);

joypad->set_stick(Joypad::LS, 1000, 2000);
joypad->set_pressed_buttons(Joypad::X | Joypad::DPAD_RIGHT);

auto rumble_data = std::make_shared<std::pair<int, int>>();
joypad.set_on_rumble([rumble_data](int low_freq, int high_freq) {
    rumble_data->first = low_freq;
    rumble_data->second = high_freq;
});

For more examples you can look at the unit tests under tests/: Joypads have been tested using SDL2 other input devices have been tested with libinput.

The main interface is easily accessible under include/inputtino/input.hpp