An easy to use virtual input library for Linux built on top of uinput, evdev and uhid.
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)
Interested in how the joypad works under the hood? Checkout these blog posts:
- When uinput Isn’t Enough: Virtualizing a DualSense controller
- Creating a Virtual DualSense Controller via UHID
- Beyond USB: Improving Virtual Controller Support in Linux Games
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)#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
Checkout the instructions in bindings/python/; example usage:
from inputtino import Mouse, MouseButton
# Initialize mouse device
mouse = Mouse()
# Move mouse
mouse.move(100, 50) # Move right 100, down 50
mouse.move_abs(500, 300, 1920, 1080) # Move to absolute position
# Click operations
mouse.click(MouseButton.LEFT)
mouse.click(MouseButton.RIGHT, duration=0.5) # Hold for 0.5 seconds
# Scrolling
mouse.scroll_vertical(120) # Scroll up
mouse.scroll_horizontal(-120) # Scroll left