Skip to content

Joystext allows you to use videogame joysticks as keyboard and mouse for computers.

Notifications You must be signed in to change notification settings

marcofognog/joystext

Repository files navigation

Joystext

Joystext allows you to use you XBox 360 joystick as keyboard and mouse for computers. More supported joystiscks are to come.

Watch it in action: https://www.youtube.com/watch?v=zohGnmS97-I

Run a sample config

  1. Copy the sample config file from vendor/jhl/samples/simple-nav.jhl to ~/.joystext
  2. Plug your XBox 360 joystick
  3. Run (in the root of the project), you'll need Ruby installed: $ ./start
  4. You should be able to move your mouse and left click using the joystick.

JHL - Configuration Language Syntax

Each configuration definition has three parts: the trigger type, the trigger name (joystick key) and an action to be performed.

So the line in our simple-nav.jhl sample

>F1: click_left

means 'whenever theres a press on the key F1 of the joystick, run the command click_left', and that is going to trigger the left button click of a mouse.

Trigger names

F1, F2, F3, F4, A1, A2, A3, A4, S1, S2, S3, S4, start, select are the buttons in the joystick that are supported for now, mapped according to the image:

mapped-keys

(Memorization tip: F is for the 'face buttons', A is for the Axis buttons, S is for the shoulder buttons)

Trigger types

It's the way a joystick button behaves when pressed/released.

There are 5 types of triggers:

*F1 triggers when pressed, than waits for a while, then repeats the action (kind of what a normal keyboard does, try holding the 'g' key on a text editor, for example, to see what I mean)

>F1 triggers once when the key is pressed, no matter how long it is held, triggers only once, ignore combinations.

<F1 triggers when the key is released but ignore combinations.

F1 triggers when the key is realeased. (this is usefull for combining keys).

.F1 triggers repeatedly for as long as the key is held (with no waiting).

Modes

Modes are groups of definitions, so you can have a mode for writing text, another for mouse and yet another for macros.

Modes are defined with:

mode 'macros'

Than whatever comes after this line is in the mode named 'macros'

The command switch_to_mode is used to define how one can enter the mode:

mode 'macros'

.F1 "thanks"
select: switch_to_mode 'text'

mode 'text'

.F1: a
start:switch_to_mode 'macros'

In the above example, whenever the user presses the start button on the joystick, it will rebind all the commands accoding to the mode defition for 'macros'.

Remaps

TODO

About

Joystext allows you to use videogame joysticks as keyboard and mouse for computers.

Resources

Stars

Watchers

Forks

Packages

No packages published