Guide

This guide was generated based on the following options:

• Operating System: linux
• Platform: ps4
• Control Scheme: Pad
• Connection Type: BT

If you want to change any of these options please go back to the main page.

Capabilities and limitations

GIMX allows to emulate a Dualshock 4. Any game controller (gamepad, joystick, fightstick...) can be used. All controls are working including touchpad. Motion sensing controls are not supported. Audio is not supported as well (but it is possible to use another Dualshock 4).

Rumble should work with any controller that has rumble support at driver level. Rumble commands are either directed to the controller defined in the FFB tweaks, or to the first controller found in the configuration that has a binding to the left stick x axis.

Hardware requirements

1. Computer
   

   PC running Ubuntu 18.04 or derivatives such as Linux Mint 19
   OR
   Raspberry Pi running Raspbian Stretch (experimental)

2. Bluetooth adapter
   Using a bluetooth dongle or an internal bluetooth module, GIMX can disguise itself as a controller to your console.
   While all bluetooth dongles/modules can't work with GIMX, working dongles are quite common. Check the compatibility list.
   
3. Genuine Dualshock 4 controller
   It is required because GIMX has to authenticate to the PS4.
4. An AVR USB board such as the Teensy 2.0
   It is required for the bluetooth pairing procedure.

Before Installation

Add "universe" to your software sources

• Start Ubuntu Software Center.

• Click Edit>Software Sources.

• Select "Community-maintained Open Source software (universe)", and close.

Refresh software sources

If you are running from a Live CD or a Live USB, you have to manually refresh software sources:

• Click on the Ubuntu desk.

• In the search area, type "terminal" with no quotes, and hit enter.

• In the terminal, type "sudo apt-get update" with no quotes, and hit enter.

GIMX Installation

Depending on architecture of your system choose correct package.

• Downloard the .deb file: 32bits or 64bits
• Install it (double click, then install).

Downloading configurations

Downloading configurations directly from gimx-launcher (recommended)

Most config files shared by users of the GIMX community can be downloaded directly from gimx-launcher. To check all available configurations please refer to Configurations Index page on this wiki.

Please contribute by sharing your own configs in the Configuration and Requests forum section.

• Run gimx-launcher

• The first time gimx-launcher is started, if there is no config file present on the PC, a message box will ask you if config files should be downloaded.
  

• The config file downloader is also available through the "Help>Get configs" menu entry.
  

• The config file downloader displays all config files available to download:
  

The config name syntax is: <CONSOLE>_<GAME>_<AUTHOR>.xml or <CONSOLE>_<OS>_<DEVICE>_<AUTHOR>.xml. Examples:

• LogitechDrivingForceGT_G29.xml: config file to use with Logitech Driving Force GT for emulating a G29.
• PS3_Battlefield3_McKack.xml: config file to use with mouse built by McKack for the PS3 version of Battlefield 3.
• PS3_X360Pad.xml: config file to use with a 360 pad and a PS3.

Just select configurations you want to download and click OK, program will do the rest and you can now use config you've downloaded.

If you can't find configuration that matches your needs in gimx-launcher nor in Configurations Index you may need to create one by yourself.

Downloading configurations manually

Some configurations aren't pushed to the repository for various reasons including:

• lack of ADS (right-click aim) profile
• mislabeled controls
• being untested
• low quality

Note: As for time of writing this article all configurations need to be hosted on the forum now so they will never get deleted. Some older configs however may be hosted on external download servers and you will need to download them from these servers first in order to use them.

If you want to try them anyway, use the following guide:

• Go directly to the Configurations Index page on this wiki, select configuration you wish to download and click "More Info" link.
• Copy config to clipboard or download it from external server
• Open your gimx-launcher
• Click File->Open config directory
• Create a new text file with name you wish to use (make sure to add .xml after the name), open it using notepad and paste data. Then save the file.
• Click File->Refresh in gimx-launcher so config will appear on the configurations list or simply restart gimx-launcher.

Editing configurations

Sometimes you would want to edit a configuration to match your needs. That includes:

• Reassigning keys
• Increasing/Decreasing sensitivity
• Playing with other values

In order to do it, please check following tutorial.

Creating configurations

If you can't find configuration that satisfies you, for example when:

• Using Steering wheel that there's no ready-made config for
• Trying to play a game using a mouse that there's no premade config for
• Any other cases when you want to customize configuration to the max

You may need to create your own configuration. In order to do it please check Creating Configurations tutorial.

Loading firmware

A Teensy 2.0 or an Arduino Micro is required in order to pair the Bluetooth dongle to the PS4.
For the Teensy 2.0 you can use the Teensy Loader.
For the Arduino Micro you may use the Arduino Builder.
The firmware with the needed "atmega32u4.hex" file is available at: http://gimx.fr/download/EMUPS4PAIRING.7z

Connecting to the console

Raspbian-specific instructions

The bluetooth service is automatically started when a device tries to connect.
This is annoying since it will intercept the connection requests.
To disable the service, run the following command and reboot:

sudo update-rc.d bluetooth disable

Alternatively, you can stop the bluetooth service and move the bluetoothd binary:

sudo service bluetooth stop
cd /usr/sbin
sudo mv bluetoothd bluetoothd.bk

The drawback of this second method is that it will need to be performed again after each update of the bluez package.

First-start instructions

TODO: Where to split and what are instructions for second-time connection?

1. Open gimx-launcher.
2. In the "Output" drop-down menu, select "Bluetooth / PS4".
3. If no previous pairing was defined, you will be asked to create a new pairing. Click on "Yes".
4. As requested, connect a compatible bluetooth dongle, and click on "Yes".
5. As requested, connect a Dualshock 4 with a micro USB cable, and click on "Yes".
6. Select the pairing to use and click on "Validate".
7. Connect the AVR USB board (e.g. Teensy 2.0) and click on "Yes".
8. As requested, connect the AVR USB board to the PS4, and wait a few seconds.
9. Connect the AVR USB board back to the computer, and click on "Yes".
10. A new pairing should appear in the "Pairing" drop-down menu.
11. Unplug the Dualshock 4.
12. In the "Config" drop-down menu, select the configuration file to use.
13. Click on "Start".
14. Press on the PS button of the Dualshock 4.
15. Play.
16. Press Left Shift + Escape to quit.

Playing with GIMX

TODO: ADD BT INSTRUCTIONS