Skip to content

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

Notifications You must be signed in to change notification settings

Vantskruv/wejoy

Repository files navigation

wejoy v0.2

'wejoy' is a tool to read physical joystick devices, aswell as keyboards, 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 events from several connected keyboards
  • 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:

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

Prepare ----

Your user must be a member of input group to read keyboard and joystick devices. For an example, in Arch Linux, you can add yourself as an user in that group:

  • $ gpasswd -a user group where user is you and group is input. See respective Linux distribution how to do this.

Usage ----

If the module uinput is not loaded on your system, you need to manually load it:

  • $ sudo modprobe uinput
  • As for now, 'wejoy' need to be run as root:
  • $ sudo ./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.

KNOWN BUGS ----

  • Every axis and button is not tested to work fully.

About

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

Resources

Stars

Watchers

Forks

Packages

No packages published