View source for Command line/en

<languages />
==Motivation==

It's not for performance at this time, but a future release may be able to run entirely from a Linux terminal without having to run a windowing system.<br/>
This would improve performances on all hardwares, especially on small ones like the [http://www.raspberrypi.org/ raspberry pi] or [http://en.wikipedia.org/wiki/Thin_client thin clients].<br/>
It's also useful for other stuff like automation.

==Linux + bluetooth==

In a terminal:<br/>
    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).<br/>
This argument is optional, default device index is 0.
* sixaxis_index
:The sixaxis index (ex : 0 for sixaxis 1, 1 for sixaxis 2, etc).<br/>
:This argument is optional, default sixaxis index is 0.

In another terminal:<br/>
    emuclient --config file_name

* file_name
:The name of the config file, in the ~/.emuclient/config directory (ex : toto.xml).<br/>
:This argument is mandatory.<br/>
:Use backslashes to escape spaces.

==Linux or Windows + DIY USB adapter or GPP==

In a terminal:<br/>
    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).<br/>
:This argument is mandatory.
* --serial --port /dev/ttyUSB0
:The serial port. Ex: /dev/ttyUSB0 in Linux, COM4 in windows.<br/>
: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.<br/>
:Recommended values:<br/>
:joystick/GPP/360pad/Sixaxis: 4 (250Hz)<br/>
:PS2pad: 16 (62.5Hz)

==General emuclient options==

* --curses
:[http://en.wikipedia.org/wiki/Curses_%28programming_library%29 curses] terminal display.<br/>
:Mouse calibration is available through this interface.
* --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.<br/>
:The main use case for this is the automation of macro's execution.<br/>
:Events that are not generated by macros are ignored.<br/>
: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.<br/>
:Another use case is the sending of a single command (it requires to use a macro as no key up event is generated).