Difference between revisions of "Main Page"

From GIMX
Jump to: navigation, search
(Marked this version for translation)

(5 intermediate revisions by the same user not shown)

Line 1: Line 1:
 
<languages />
 
<languages />
<translate><!--T:11-->
+
<translate>
 +
<!--T:11-->
 
Welcome to the GIMX wiki!<br />
 
Welcome to the GIMX wiki!<br />
 
Feel free to create an account and contribute!<br />
 
Feel free to create an account and contribute!<br />
 
Check [[Translate|this page]] for translation instructions.
 
Check [[Translate|this page]] for translation instructions.
  
==About GIMX== <!--T:13-->
+
<!--T:13-->
 +
==About GIMX==
  
 
<!--T:14-->
 
<!--T:14-->
Line 34: Line 36:
 
To contribute to GIMX, see the [[Contribute|Contribute page]].
 
To contribute to GIMX, see the [[Contribute|Contribute page]].
  
==Hardware requirements== <!--T:21-->
+
<!--T:21-->
 +
==Hardware requirements==
 +
 
 +
<!--T:22-->
 +
===Computer===
 +
 
 +
<div class="mw-collapsible mw-collapsed">
  
===Computer=== <!--T:22-->
 
 
GIMX is designed to run on a computer running Ubuntu-based GNU/Linux distributions or Windows (7 or later). This is a strong requirement.<br />
 
GIMX is designed to run on a computer running Ubuntu-based GNU/Linux distributions or Windows (7 or later). This is a strong requirement.<br />
 
GIMX can run on smaller targets such as the [https://en.wikipedia.org/wiki/Raspberry_Pi Raspberry Pi] or Thin clients running a small Linux distro.
 
GIMX can run on smaller targets such as the [https://en.wikipedia.org/wiki/Raspberry_Pi Raspberry Pi] or Thin clients running a small Linux distro.
Line 49: Line 56:
 
:Another way to use GIMX is to run it from a Ubuntu [http://www.pendrivelinux.com/universal-usb-installer-easy-as-1-2-3/ Live USB Persistent Flash Drive].
 
:Another way to use GIMX is to run it from a Ubuntu [http://www.pendrivelinux.com/universal-usb-installer-easy-as-1-2-3/ Live USB Persistent Flash Drive].
  
===Connector=== <!--T:24-->
+
</div>
 +
 
 +
===Connector===
 +
 
 +
<div class="mw-collapsible mw-collapsed">
 +
 
 +
<!--T:24-->
 
====Bluetooth dongle====
 
====Bluetooth dongle====
 +
 +
<div class="mw-collapsible mw-collapsed">
 +
 
:OS compatibility: Ubuntu-based GNU/Linux distributions only (there is no appropriate access to the bluetooth stack on Windows).<br />
 
:OS compatibility: Ubuntu-based GNU/Linux distributions only (there is no appropriate access to the bluetooth stack on Windows).<br />
  
Line 59: Line 75:
 
:While all bluetooth dongles/modules can't work with GIMX, working dongles are quite common. Check the [[Bluetooth_dongle|compatibility list]].
 
:While all bluetooth dongles/modules can't work with GIMX, working dongles are quite common. Check the [[Bluetooth_dongle|compatibility list]].
 
:For PS4 only:
 
:For PS4 only:
:*A genuine DS4 controller is required because GIMX has to authenticate to the PS4.
+
:*A genuine Dualshock 4 controller is required because GIMX has to authenticate to the PS4.
 
:*An AVR USB board such as the Teensy 2.0 is also required for the bluetooth pairing procedure.
 
:*An AVR USB board such as the Teensy 2.0 is also required for the bluetooth pairing procedure.
  
====USB adapter==== <!--T:25-->
+
</div>
 +
 
 +
<!--T:25-->
 +
====USB adapter====
 +
 
 +
<div class="mw-collapsible mw-collapsed">
 +
 
 
:OS compatibility: Ubuntu-based GNU/Linux distributions and Windows (7 or later).<br />
 
:OS compatibility: Ubuntu-based GNU/Linux distributions and Windows (7 or later).<br />
 
=====GIMX adapter=====
 
=====GIMX adapter=====
:Using a specific [[DIY_USB_adapter|Do-It-Yourself USB adapter]], the following emulations are available:
+
:This is an adapter that you can either build yourself or buy from the GIMX shop:
:{{Firmwares/en}}
+
:* [[DIY_USB_adapter|Build yourself a GIMX adapter]]
:All Logitech wheel emulations have [[Force_Feedback|force feedback support]].
+
:* '''[https://blog.gimx.fr/product/gimx-adapter/ Buy a ready to use GIMX adapter from the official GIMX shop.]'''
:'''[https://blog.gimx.fr/shop/ Buy a ready to use GIMX adapter from the official GIMX shop.]'''
 
:{{Third_party_adapters}}
 
 
<!--
 
<!--
 
Matlo 2017-03-30:
 
Matlo 2017-03-30:
Line 76: Line 96:
 
The official GIMX shop generates some revenue to the GIMX creator and helps keeping up the GIMX development.
 
The official GIMX shop generates some revenue to the GIMX creator and helps keeping up the GIMX development.
 
-->
 
-->
 +
:With a GIMX adapter, the following emulations are available:
 +
:{{Firmwares/en}}
 +
:All Logitech wheel emulations have [[Force_Feedback|force feedback support]].
 +
:{{Third_party_adapters}}
 
:Notes:
 
:Notes:
 
::Forget about using any other USB to USB cable (like file transfer cables, or direct cables), they are not suited to this use.<br />
 
::Forget about using any other USB to USB cable (like file transfer cables, or direct cables), they are not suited to this use.<br />
 
::For 360: a genuine wired 360 controller is required because the USB adapter has to authenticate to the console. A wireless 360 controller with a play and charge kit will NOT work.
 
::For 360: a genuine wired 360 controller is required because the USB adapter has to authenticate to the console. A wireless 360 controller with a play and charge kit will NOT work.
::For PS4: a genuine DS4 controller is required because GIMX has to authenticate to the console.
+
::For PS4: a genuine Dualshock 4 controller is required because GIMX has to authenticate to the console.
 
::For Xbox One: a genuine Xbox One controller is required because GIMX has to authenticate to the console. Controllers with the 3.5mm jack are not supported yet.
 
::For Xbox One: a genuine Xbox One controller is required because GIMX has to authenticate to the console. Controllers with the 3.5mm jack are not supported yet.
  
=====Titan One===== <!--T:67-->
+
<!--T:67-->
 +
=====Titan One=====
 
:GIMX can also emulate a '''gamepad''' (not a wheel) using a [http://www.consoletuner.com/ Titan One] (formerly known as GamepadProxy/Cronus/CronusMax). The Titan One can work with the PS3, the Xbox 360, the Xbox One, and the PS4.<br />
 
:GIMX can also emulate a '''gamepad''' (not a wheel) using a [http://www.consoletuner.com/ Titan One] (formerly known as GamepadProxy/Cronus/CronusMax). The Titan One can work with the PS3, the Xbox 360, the Xbox One, and the PS4.<br />
  
===Gaming mouse=== <!--T:26-->
+
</div>
 +
</div>
 +
 
 +
<!--T:26-->
 +
===Gaming mouse===
 +
 
 +
<div class="mw-collapsible mw-collapsed">
 +
 
 
If you want to play console FPS games with a mouse, forget about using a mouse with anything less than 2000DPI and 250Hz.<br />
 
If you want to play console FPS games with a mouse, forget about using a mouse with anything less than 2000DPI and 250Hz.<br />
 
A gaming mouse with 5000+ DPI and running at 500Hz is highly recommended.<br />
 
A gaming mouse with 5000+ DPI and running at 500Hz is highly recommended.<br />
Line 92: Line 124:
 
A high DPI mouse gives a better linearity (i.e. smoother movements) in this specific case.
 
A high DPI mouse gives a better linearity (i.e. smoother movements) in this specific case.
  
==Tutorials== <!--T:27-->
+
</div>
 +
 
 +
<!--T:27-->
 +
==Tutorials==
  
 
<!--T:28-->
 
<!--T:28-->
Line 130: Line 165:
 
'''[[CHIP|C.H.I.P. Quick setup guide]]'''
 
'''[[CHIP|C.H.I.P. Quick setup guide]]'''
  
==Troubleshooting== <!--T:33-->
+
<!--T:33-->
 +
==Troubleshooting==
  
 
<!--T:34-->
 
<!--T:34-->
Line 137: Line 173:
 
If you think you may have misconfigured something, ask for help on the [https://gimx.fr/forum/viewforum.php?f=5 forum].
 
If you think you may have misconfigured something, ask for help on the [https://gimx.fr/forum/viewforum.php?f=5 forum].
  
==Old tutorials== <!--T:35-->
+
<!--T:35-->
 +
==Old tutorials==
 +
 
 +
<div class="mw-collapsible mw-collapsed">
  
 
<!--T:55-->
 
<!--T:55-->
Line 159: Line 198:
 
* [http://forum.gimx.fr/viewtopic.php?f=4&t=39 English]
 
* [http://forum.gimx.fr/viewtopic.php?f=4&t=39 English]
  
==GIMX "the hard way"== <!--T:56-->
+
</div>
 +
 
 +
<!--T:56-->
 +
==GIMX "the hard way"==
  
 
<!--T:49-->
 
<!--T:49-->
Line 169: Line 211:
 
<!--T:51-->
 
<!--T:51-->
 
'''Development'''
 
'''Development'''
 +
 +
<div class="mw-collapsible mw-collapsed">
  
 
<!--T:52-->
 
<!--T:52-->
Line 184: Line 228:
 
** [[T300RS_PS4|T300RS PS4]]
 
** [[T300RS_PS4|T300RS PS4]]
 
** [[G27_PS3|G27 PS3]]
 
** [[G27_PS3|G27 PS3]]
 +
 +
</div>
 
</translate>
 
</translate>

Revision as of 22:29, 20 July 2017

Other languages:
čeština • ‎Deutsch • ‎English • ‎français • ‎italiano • ‎polski

Welcome to the GIMX wiki!
Feel free to create an account and contribute!
Check this page for translation instructions.

About GIMX

GIMX stands for Game Input MultipleXer or Game Input MatriX. The purpose of this free software is to control a video game console with a computer (e.g. a PC or a Raspberry Pi). It works with the PS3, the Xbox 360, the PS4 and the Xbox One.

It operates:

  • over bluetooth: works with GNU/Linux (PS3, PS4) only. A compatible bluetooth dongle is required. A USB development board such as a Teensy 2.00 is required for pairing the bluetooth dongle with the PS4.
  • over usb: works with GNU/Linux and Windows (PS3, PS4, 360, XOne). A USB adapter is required.

The application gets data from the peripherals (mice, keyboards and joysticks) and sends controls to the console over bluetooth or usb.
Other controls such as gesture or voice are possible through the use of external software that emulate peripherals.

GIMX features are further described on the Features page.

Compatibility issues are listed on the Compatibility page.

The source code of GIMX is available under the GPLv3 here.

There's also a blog with a few posts about the GIMX development, and a support forum.

To contribute to GIMX, see the Contribute page.

Hardware requirements

Computer

GIMX is designed to run on a computer running Ubuntu-based GNU/Linux distributions or Windows (7 or later). This is a strong requirement.
GIMX can run on smaller targets such as the Raspberry Pi or Thin clients running a small Linux distro.

About Ubuntu and Raspbian:

The only supported versions are Ubuntu 16.04 and Raspbian Jessie, to use with latest GIMX.
It's also possible to use Ubuntu derivates such as Linux Mint.
Running GIMX in a virtual machine (vmware, virtualbox...) is NOT OFFICIALY supported (no help will be given for that).
It's possible to run Ubuntu from a live usb disk (nothing is saved on the hard drive).
Feel free to install Ubuntu on your computer! If you have a Windows OS installed, you can read this page if you want to install Ubuntu on your hard drive without erasing the Windows OS.
Another way to use GIMX is to run it from a Ubuntu Live USB Persistent Flash Drive.

Connector

Bluetooth dongle

OS compatibility: Ubuntu-based GNU/Linux distributions only (there is no appropriate access to the bluetooth stack on Windows).
Using a bluetooth dongle or an internal bluetooth module, GIMX can emulate the following controllers:
  • Dualshock 3, for PS3
  • Dualshock 4, for PS4
While all bluetooth dongles/modules can't work with GIMX, working dongles are quite common. Check the compatibility list.
For PS4 only:
  • A genuine Dualshock 4 controller is required because GIMX has to authenticate to the PS4.
  • An AVR USB board such as the Teensy 2.0 is also required for the bluetooth pairing procedure.

USB adapter

OS compatibility: Ubuntu-based GNU/Linux distributions and Windows (7 or later).
GIMX adapter
This is an adapter that you can either build yourself or buy from the GIMX shop:
With a GIMX adapter, the following emulations are available:
  • EMUJOYSTICKPS3: HID joystick emulation, with 16bit stick axes, for PS3
  • EMUPS3: Sixaxis emulation, for PS3
  • EMU360: 360 pad emulation, for Xbox 360
  • EMUPS4: Hori Pad FPS Plus emulation, for PS4 (with touchpad support)
  • EMUXONE: Xbox One pad emulation, for Xbox One
  • EMUG29PS4: Logitech G29 gaming wheel emulation, for PS4, with force feedback support
  • EMUG27PS3: Logitech G27 gaming wheel emulation, for PS3, with force feedback support
  • EMUGTFPS2: Logitech GT Force emulation, for PS2, with force feedback support
  • EMUDFPS2: Logitech Driving Force emulation, for PS2, with force feedback support
  • EMUDFPPS2: Logitech Driving Force Pro emulation, for PS2, with force feedback support
  • EMUG27PC: Logitech G27 gaming wheel emulation, for PC, force feedback support
All Logitech wheel emulations have force feedback support.
Notes:
Forget about using any other USB to USB cable (like file transfer cables, or direct cables), they are not suited to this use.
For 360: a genuine wired 360 controller is required because the USB adapter has to authenticate to the console. A wireless 360 controller with a play and charge kit will NOT work.
For PS4: a genuine Dualshock 4 controller is required because GIMX has to authenticate to the console.
For Xbox One: a genuine Xbox One controller is required because GIMX has to authenticate to the console. Controllers with the 3.5mm jack are not supported yet.
Titan One
GIMX can also emulate a gamepad (not a wheel) using a Titan One (formerly known as GamepadProxy/Cronus/CronusMax). The Titan One can work with the PS3, the Xbox 360, the Xbox One, and the PS4.

Gaming mouse

If you want to play console FPS games with a mouse, forget about using a mouse with anything less than 2000DPI and 250Hz.
A gaming mouse with 5000+ DPI and running at 500Hz is highly recommended.
Whereas a gaming mouse with more than 1600 DPI doesn't really make a difference on a computer, it's not the case with GIMX.
GIMX can decelerate mouse movements so as to counteract the in-game acceleration.
A high DPI mouse gives a better linearity (i.e. smoother movements) in this specific case.

Tutorials

Software installation

Quick start

Config editors

Axis translation parameters

Mouse calibration

Mouse tweaks

Macros

DIY USB adapter

DIY USB adapter for dummies

Logitech force feedback wheels

Raspberry Pi setup hints

C.H.I.P. Quick setup guide

Troubleshooting

First make sure you have the latest GIMX version.
Then look at the FAQ and the bug list, see if your problem is already known, and if it's not, report it.
If you think you may have misconfigured something, ask for help on the forum.

Old tutorials

Translations

The GIMX version in these tutorials is 0.24: they are outdated.

Configuration & Calibration

This tutorial gives more details about how to adjust your configuration with gimx-config.

GIMX "the hard way"

Running GIMX from the command line

Development