Command line

Linux + bluetooth

In a terminal:

   emu ps3_mac_address bt_device_index sixaxis_index

• ps3_mac_address

this argument is mandatory

• bt_device_index

the bluetooth device index (ex : 0 for hci0, 1 for hci1, etc)

this argument is optional, default device index is 0

• sixaxis_index

the sixaxis index (ex : 0 for sixaxis 1, 1 for sixaxis 2, etc)

this argument is optional, default sixaxis index is 0

In another terminal:

   emuclient --config file_name

• file_name

the name of the config file, in the ~/.emuclient/config directory (ex : toto.xml)

this argument is mandatory

use backslashes to escape spaces

Linux or Windows + DIY USB adapter or GPP

In a terminal:

   emuclient --config file_name --serial --port /dev/ttyUSBX --joystick --precision 16 --refresh 4

emuclient options:

• file_name

the name of the config file, in the ~/.emuclient/config directory (ex : toto.xml)

this argument is mandatory

• --serial --port /dev/ttyUSB0

serial port, ex /dev/ttyUSB0 in Linux, COM4 in windows

only mandatory for the DIY USB adapter

• --joystick / --GPP / --360pad / --Sixaxis / --PS2pad

the type of USB adapter

• --precision 16

the axis precision (joystick: 16, other adapters: 8)

• --refresh 4

the refresh period, in ms

recommended values:

joystick/GPP/360pad/Sixaxis: 4 (250Hz)

PS2pad: 16 (62.5Hz)

General emuclient options

• --status

display controls in the terminal

• --nograb

do not grab the mouse cursor

• --force-updates

send button+axis status even if there is no change (for compatibility with games like DNF)

• --subpos

improve stick precision (counteract rounding issues)

• --keygen key

generate a key press at emuclient startup

the main use case for this is the automation of macro's execution

all other events are ignored, except events generated by macros

the only way to quit is to add KEYDOWN ESCAPE at the end of the macro, or use --nograb and press ctrl+c into the terminal another use case is the sending of a single command (it requires to use a macro as no key up event is generated).