View Code? Open in Web Editor NEW

This project forked from sanjay900/wejoy

Tool to read physical joystick devices, create virtual joystick devices and output keyboard presses on a Linux system.

C++ 95.58% Lua 2.07% C 1.31% CMake 0.25% Python 0.80%

wejoy's Introduction

wejoy v0.1

'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:

Features ----

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

Known requirements ----

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.

Compile ----

$ 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.

Usage ----

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'.

LUA scripting ----

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.