xjoy2key 0.1.0 Copyright 2010 Eric Lathrop <eric@ericlathrop.com> xjoy2key is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. xjoy2key is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with xjoy2key. If not, see <http://www.gnu.org/licenses/>. What is xjoy2key? ================= xjoy2key maps your joystick button presses to keyboard key presses so you can play games with a joystick that don't support one natively. Setup and usage =============== The first time you run xjoy2key you'll need to have it generate a configuration file for you to edit. Plug in your joystick and run: xjoy2key --config /dev/input/js0 >somegame.cfg where js0 is the device name of your joystick. Edit the file generated to change which keyboard keys are sent for each button or axis. The line: axis -3 Left -32767 sets the negative end of the 3rd axis to send the keyboard's left arrow when it reaches a value of -32767 or lower. The line: button 2 Shift_L sets the 2nd button to send the keyboard's left shift key when it is pressed. Use the jscal program to identify the buttons and axes on your joystick. (Mine reported several phantom axes and buttons that didn't exist). Look in /usr/include/X11/keysymdef.h to find the names of the keys you can use. Once your configuration file is set up, run: xjoy2key somegame.cfg You should be able to test your configuration by opening a text editor and pressing joystick buttons to make sure the right keys are sent. That's it! Have fun playing your games!