There isn't much documentation on the game I'm playing using WINE, and it doesn't detect a joystick. I want to use joy2key to map keyboard keys to joystick buttons, but can't figure out exactly how to use its command line interface.

joy2key -dev /dev/input/js0 -terminal

That command shows what to press, but I can't figure out how to map the keys since the instructions are not clear.


2 Answers 2


You can use antimicro, it is a fork of joy2key and has a GUI, use this PPA for 12.04 to 15.10

sudo add-apt-repository ppa:ryochan7/antimicro
sudo apt-get update
sudo apt-get install antimicro

For 16.04 to 17.10 use this PPA

sudo add-apt-repository ppa:mdeguzis/libregeek
sudo apt-get update
sudo apt-get install antimicro


Screnshot of AntiMicro and key mapping

  • Thanks a ton do you know ho much time i have spent fixing compilation of rejoystick and figuring out how joy2ky works ? around 2 hours now Jan 12, 2016 at 18:38
  • I too have been through this hell, I assure you, this is a great application :)
    – Mark Kirby
    Jan 12, 2016 at 18:41
  • they changed the package name its antimicro now insted of anti-micro Jan 12, 2016 at 18:48
  • 1
    @levitopher Updated for 16.04+ versions of Ubuntu.
    – Mark Kirby
    Oct 2, 2017 at 18:46
  • 1
    There is not version for 18.04. You can follow instructions to compile in antimicro repository. Jul 12, 2018 at 2:26

For those looking for a solution that's easily installable on Ubuntu 18.04+, I found qjoypad in the official Ubuntu repositories. Install it like this:

sudo apt install qjoypad

Then, it should be available in your launcher. It starts as a system tray icon, and you can launch the configurator by right clicking on it.

Personally, I really like the quick bind option that lets you press a key on a gamepad and then a key on your keyboard to update the mapping for that layout automatically. Note that it does indeed natively support multiple gamepads.

For me, I had some trouble with getting the right click to launch the configurator to work on the Unity 7.5 desktop - and the left-click menu doesn't appear to have an option for launching it. Thankfully, there's a workaround for this too. Simply launch qjoypad like so:

qjoypad --notray

....this will disable the system tray icon and instead launch a window with the icon in it instead - which works as expected.

This can be made to happen automatically by editing /usr/share/applications/qjoypad.desktop. Find the line that starts with Exec=, and append --notray to the end of it (make sure that there's a space after qjoypad at the end of the line and --notray).

  • 1
    This solution works in Debian too.
    – tres.14159
    Feb 1, 2020 at 22:22

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.