'wejoy' is a tool to read physical joystick devices, create virtual joystick devices and output keyboard presses on a Linux system. It uses helpful sourcecode which in somewhat degree is modified:
- https://github.com/tuomasjjrasanen/libsuinput
- https://github.com/drewnoakes/joystick
- https://github.com/EliasD/unnamed_lua_binder/
- Create one or more virtual joysticks with a custom number of buttons and axes.
- Read physical joystick buttons and and axes events.
- Send keyboard events
- Lua scripting for conditional purposes
- liblua version 5.2 or later.
- libudev
Development files for liblua and libudev are required for compliation:
- Search for which version of liblua you may have in your version of Linux distribution:
$ apt-cache search liblua
You may have liblua5.2 or a newer version.
Then install the developments files of you version of liblua and libudev i.e:
- $ sudo apt-get install liblua5.x-dev libudev-dev
Also install the shared libraries of liblua and libudev i.e:
- $ sudo apt-get install liblua5.x-0 libudev1
Where 5.x is the available liblua version of your distro.
- $ sh make.sh
- This will create an executable called 'wejoy' which is run from the terminal.
- NOTE: If another version than liblua 5.2 is installed, the make.sh needs to be edited for the current version installed.
If the module uinput is not loaded on your system, you need to manually load it:
- $ sudo modprobe uinput
- And then it can be run with
- /wejoy script.lua
- Where script.lua is your preferred configuration file.
- You can quit 'wejoy' by pressing 'q' end then 'ENTER'.
- Please read the example.lua and warthog_throttle.lua to learn how to customize your script.
- Also read the keycodes_ref.txt for keyboard reference. These variables are globally accessable in your LUA script.
- Tests currently require sudo privileges.