GIMX - User contributions [en]

CHIP

2016-12-20T05:44:00Z

Cajuil: /* GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) */

== Power Limitations ==

C.H.I.P. is '''limited to 900mA''' by default thus connecting an USB HUB or any other Periphal that requires more than that will make the device to abruptly '''turn off'''.

At the time of this writing, version 4.4 No-limit won't be enough. You'll have to make changes in the system to remove this limitation.

Please refer to: [http://www.chip-community.org/index.php/Troubleshooting#Abrupt_Shutdowns Abrupt Shutdowns] for more information.

== Modifying C.H.I.P. Power Limitations ==

The following steps and script is Copyrighted by Steven Ford http://geeky-boy.com/ and licensed "public domain style under [http://creativecommons.org/publicdomain/zero/1.0/ CC0].

If you are having power problems, you should first log into CHIP with all peripherals disconnected. These instructions assume you are in a shell prompt on CHIP.

'''Step 1.''' Get the shell script file onto CHIP:

sudo wget -O /etc/init.d/axp209-nolim <nowiki>http://fordsfords.github.io/axp209-nolim/axp209-nolim</nowiki>
 sudo chmod +x /etc/init.d/axp209-nolim
 sudo update-rc.d axp209-nolim defaults

'''Step 2.''' Now, do a graceful restart:

sudo shutdown -r now

For more information refer to: https://github.com/fordsfords/axp209-nolim

== GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) ==

This guide will assume you've already configured your CHIP's WiFi connection (by using the command: nmtui) and know it's IP address to be able to connect to it.

'''Step 1.''' Download and Install GIMX

wget <nowiki>https://gimx.fr/download/gimx-raspbian</nowiki> -O gimx.deb
 sudo dpkg -i gimx.deb
 sudo apt-get -f install

'''Step 2.''' Stop & Disable Console TTY (make sure u are connected through SSH) 
sudo systemctl mask serial-getty@ttyS0.service 
sudo systemctl stop serial-getty@ttyS0.service

'''Step 3.''' Create GIMX directories 
mkdir ~/.gimx; mkdir ~/.gimx/macros; mkdir ~/.gimx/config

'''Step 4.''' Download and move the Configurations 
wget https://github.com/matlo/GIMX-configurations/archive/master.zip

unzip master.zip 
mv GIMX-configurations-master/Linux/* ~/.gimx/config 

'''Step 5.''' Delete the file master.zip and the directory GIMX-configurations-master 
rm master.zip 
rm -rf GIMX-configurations-master

You are now ready to start using GIMX.

'''NOTE''': Keep in mind that the serial interface is '''/dev/ttyS0'''

CHIP

2016-12-20T05:40:06Z

Cajuil: /* GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) */

== Power Limitations ==

C.H.I.P. is '''limited to 900mA''' by default thus connecting an USB HUB or any other Periphal that requires more than that will make the device to abruptly '''turn off'''.

At the time of this writing, version 4.4 No-limit won't be enough. You'll have to make changes in the system to remove this limitation.

Please refer to: [http://www.chip-community.org/index.php/Troubleshooting#Abrupt_Shutdowns Abrupt Shutdowns] for more information.

== Modifying C.H.I.P. Power Limitations ==

The following steps and script is Copyrighted by Steven Ford http://geeky-boy.com/ and licensed "public domain style under [http://creativecommons.org/publicdomain/zero/1.0/ CC0].

If you are having power problems, you should first log into CHIP with all peripherals disconnected. These instructions assume you are in a shell prompt on CHIP.

'''Step 1.''' Get the shell script file onto CHIP:

sudo wget -O /etc/init.d/axp209-nolim <nowiki>http://fordsfords.github.io/axp209-nolim/axp209-nolim</nowiki>
 sudo chmod +x /etc/init.d/axp209-nolim
 sudo update-rc.d axp209-nolim defaults

'''Step 2.''' Now, do a graceful restart:

sudo shutdown -r now

For more information refer to: https://github.com/fordsfords/axp209-nolim

== GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) ==

This guide will assume you've already configured your CHIP's WiFi connection (by using the command: nmtui) and know it's IP address to be able to connect to it.

'''Step 1.''' Download and Istall GIMX

wget <nowiki>https://gimx.fr/download/gimx-raspbian</nowiki> -O gimx.deb
 sudo dpkg -i gimx.deb
 sudo apt-get -f install

'''Step 2.''' Stop & Disable Console TTY (make sure u are connected through SSH) 
sudo systemctl mask serial-getty@ttyS0.service 
sudo systemctl stop serial-getty@ttyS0.service

'''Step 3.''' Create GIMX directories 
mkdir ~/.gimx; mkdir ~/.gimx/macros; mkdir ~/.gimx/config

'''Step 4.''' Download and move the Configurations 
wget https://github.com/matlo/GIMX-configurations/archive/master.zip

unzip master.zip 
mv GIMX-configurations-master/Linux/* ~/.gimx/config 

'''Step 5.''' Delete the file master.zip and the directory GIMX-configurations-master 
rm master.zip 
rm -rf GIMX-configurations-master

You are now ready to start using GIMX.

'''NOTE''': Keep in mind that the serial interface is '''/dev/ttyS0'''

CHIP

2016-12-20T05:20:00Z

Cajuil: /* Modify C.H.I.P. Power Limitations */

== Power Limitations ==

C.H.I.P. is '''limited to 900mA''' by default thus connecting an USB HUB or any other Periphal that requires more than that will make the device to abruptly '''turn off'''.

At the time of this writing, version 4.4 No-limit won't be enough. You'll have to make changes in the system to remove this limitation.

Please refer to: [http://www.chip-community.org/index.php/Troubleshooting#Abrupt_Shutdowns Abrupt Shutdowns] for more information.

== Modifying C.H.I.P. Power Limitations ==

The following steps and script is Copyrighted by Steven Ford http://geeky-boy.com/ and licensed "public domain style under [http://creativecommons.org/publicdomain/zero/1.0/ CC0].

If you are having power problems, you should first log into CHIP with all peripherals disconnected. These instructions assume you are in a shell prompt on CHIP.

'''Step 1.''' Get the shell script file onto CHIP:

sudo wget -O /etc/init.d/axp209-nolim <nowiki>http://fordsfords.github.io/axp209-nolim/axp209-nolim</nowiki>
 sudo chmod +x /etc/init.d/axp209-nolim
 sudo update-rc.d axp209-nolim defaults

'''Step 2.''' Now, do a graceful restart:

sudo shutdown -r now

For more information refer to: https://github.com/fordsfords/axp209-nolim

== GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) ==

This guide will assume you've already configured your CHIP's WiFi connection (by using the command: nmtui) and know it's IP address to be able to connect to it.

'''Step 1.''' Download and Istall GIMX

wget <nowiki>https://gimx.fr/download/gimx-raspbian</nowiki> -O gimx.deb
 sudo dpkg -i gimx.deb
 sudo apt-get -f install

'''Step 2.''' Stop & Disable Console TTY (make sure u are connected through SSH) 
sudo systemctl mask serial-getty@ttyS0.service 
sudo systemctl stop serial-getty@ttyS0.service

'''Step 3.''' Create GIMX directories 
mkdir ~/.gimx; mkdir ~/.gimx/macros; mkdir ~/.gimx/config

'''Step 4.''' Download and move the Configurations 
wget https://github.com/matlo/GIMX-configurations/archive/master.zip

unzip master.zip 
mv GIMX-configurations-master/Linux/* ~/.gimx/config 

'''Step 5.''' Delete the file master.zip and the directory GIMX-configurations-master 
rm master.zip 
rm -rf GIMX-configurations-master

CHIP

2016-12-20T05:18:32Z

Cajuil: /* GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) */

== Power Limitations ==

C.H.I.P. is '''limited to 900mA''' by default thus connecting an USB HUB or any other Periphal that requires more than that will make the device to abruptly '''turn off'''.

At the time of this writing, version 4.4 No-limit won't be enough. You'll have to make changes in the system to remove this limitation.

Please refer to: [http://www.chip-community.org/index.php/Troubleshooting#Abrupt_Shutdowns Abrupt Shutdowns] for more information.

== Modify C.H.I.P. Power Limitations ==

The following steps and script is Copyrighted by Steven Ford http://geeky-boy.com/ and licensed "public domain style under [http://creativecommons.org/publicdomain/zero/1.0/ CC0].

If you are having power problems, you should first log into CHIP with all peripherals disconnected. These instructions assume you are in a shell prompt on CHIP.

'''Step 1.''' Get the shell script file onto CHIP:

sudo wget -O /etc/init.d/axp209-nolim <nowiki>http://fordsfords.github.io/axp209-nolim/axp209-nolim</nowiki>
 sudo chmod +x /etc/init.d/axp209-nolim
 sudo update-rc.d axp209-nolim defaults

'''Step 2.''' Now, do a graceful restart:

sudo shutdown -r now

For more information refer to: https://github.com/fordsfords/axp209-nolim

== GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) ==

This guide will assume you've already configured your CHIP's WiFi connection (by using the command: nmtui) and know it's IP address to be able to connect to it.

'''Step 1.''' Download and Istall GIMX

wget <nowiki>https://gimx.fr/download/gimx-raspbian</nowiki> -O gimx.deb
 sudo dpkg -i gimx.deb
 sudo apt-get -f install

'''Step 2.''' Stop & Disable Console TTY (make sure u are connected through SSH) 
sudo systemctl mask serial-getty@ttyS0.service 
sudo systemctl stop serial-getty@ttyS0.service

'''Step 3.''' Create GIMX directories 
mkdir ~/.gimx; mkdir ~/.gimx/macros; mkdir ~/.gimx/config

'''Step 4.''' Download and move the Configurations 
wget https://github.com/matlo/GIMX-configurations/archive/master.zip

unzip master.zip 
mv GIMX-configurations-master/Linux/* ~/.gimx/config 

'''Step 5.''' Delete the file master.zip and the directory GIMX-configurations-master 
rm master.zip 
rm -rf GIMX-configurations-master

CHIP

2016-12-20T05:17:21Z

Cajuil: /* GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) */

== Power Limitations ==

C.H.I.P. is '''limited to 900mA''' by default thus connecting an USB HUB or any other Periphal that requires more than that will make the device to abruptly '''turn off'''.

At the time of this writing, version 4.4 No-limit won't be enough. You'll have to make changes in the system to remove this limitation.

Please refer to: [http://www.chip-community.org/index.php/Troubleshooting#Abrupt_Shutdowns Abrupt Shutdowns] for more information.

== Modify C.H.I.P. Power Limitations ==

The following steps and script is Copyrighted by Steven Ford http://geeky-boy.com/ and licensed "public domain style under [http://creativecommons.org/publicdomain/zero/1.0/ CC0].

If you are having power problems, you should first log into CHIP with all peripherals disconnected. These instructions assume you are in a shell prompt on CHIP.

'''Step 1.''' Get the shell script file onto CHIP:

sudo wget -O /etc/init.d/axp209-nolim <nowiki>http://fordsfords.github.io/axp209-nolim/axp209-nolim</nowiki>
 sudo chmod +x /etc/init.d/axp209-nolim
 sudo update-rc.d axp209-nolim defaults

'''Step 2.''' Now, do a graceful restart:

sudo shutdown -r now

For more information refer to: https://github.com/fordsfords/axp209-nolim

== GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) ==

This guide will assume you've already configured your CHIP's WiFi connection (by using the command: nmtui) and know it's IP address to be able to connect to it.

'''Step 1.''' Download and Istall GIMX

wget <nowiki>https://gimx.fr/download/gimx-raspbian</nowiki> -O gimx.deb
 sudo dpkg -i gimx.deb
 sudo apt-get -f install

'''Step 2.''' Stop & Disable Console TTY (make sure u are connected through SSH) 
sudo systemctl mask serial-getty@ttyS0.service 
sudo systemctl stop serial-getty@ttyS0.service

'''Step 3.''' Create GIMX directories 
mkdir ~/.gimx; mkdir ~/.gimx/macros; mkdir ~/.gimx/config

'''Step 4.''' Download and move the Configurations 
wget https://github.com/matlo/GIMX-configurations/archive/master.zip

unzip master.zip 
cd GIMX-configurations-master 
cd Linux 
mv * ~/.gimx/config 
cd ~

'''Step 5.''' Delete the file master.zip and the directory GIMX-configurations-master 
rm master.zip 
rm -rf GIMX-configurations-master

CHIP

2016-12-20T05:16:22Z

Cajuil: /* GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) */

== Power Limitations ==

C.H.I.P. is '''limited to 900mA''' by default thus connecting an USB HUB or any other Periphal that requires more than that will make the device to abruptly '''turn off'''.

At the time of this writing, version 4.4 No-limit won't be enough. You'll have to make changes in the system to remove this limitation.

Please refer to: [http://www.chip-community.org/index.php/Troubleshooting#Abrupt_Shutdowns Abrupt Shutdowns] for more information.

== Modify C.H.I.P. Power Limitations ==

The following steps and script is Copyrighted by Steven Ford http://geeky-boy.com/ and licensed "public domain style under [http://creativecommons.org/publicdomain/zero/1.0/ CC0].

If you are having power problems, you should first log into CHIP with all peripherals disconnected. These instructions assume you are in a shell prompt on CHIP.

'''Step 1.''' Get the shell script file onto CHIP:

sudo wget -O /etc/init.d/axp209-nolim <nowiki>http://fordsfords.github.io/axp209-nolim/axp209-nolim</nowiki>
 sudo chmod +x /etc/init.d/axp209-nolim
 sudo update-rc.d axp209-nolim defaults

'''Step 2.''' Now, do a graceful restart:

sudo shutdown -r now

For more information refer to: https://github.com/fordsfords/axp209-nolim

== GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) ==

This guide will assume you've already configured your CHIP's WiFi connection (by using the command: nmtui) and know it's IP address to be able to connect to it.

'''Step 1.''' Download and Istall GIMX

wget <nowiki>https://gimx.fr/download/gimx-raspbian</nowiki> -O gimx.deb
 sudo dpkg -i gimx.deb
 sudo apt-get -f install

'''Step 2.''' Stop & Disable Console TTY (make sure u are connected through SSH) 
sudo systemctl mask serial-getty@ttyS0.service 
sudo systemctl stop serial-getty@ttyS0.service

'''Step 3.''' Create GIMX directories 
mkdir .gimx; mkdir .gimx/macros; mkdir .gimx/config

'''Step 4.''' Download and move the Configurations 
wget https://github.com/matlo/GIMX-configurations/archive/master.zip

unzip master.zip 
cd GIMX-configurations-master 
cd Linux 
mv * ~/.gimx/config 
cd ~

'''Step 5.''' Delete the file master.zip and the directory GIMX-configurations-master 
rm master.zip 
rm -rf GIMX-configurations-master

CHIP

2016-12-20T05:14:51Z

Cajuil: /* Modify C.H.I.P. Power Limitations */

== Power Limitations ==

C.H.I.P. is '''limited to 900mA''' by default thus connecting an USB HUB or any other Periphal that requires more than that will make the device to abruptly '''turn off'''.

At the time of this writing, version 4.4 No-limit won't be enough. You'll have to make changes in the system to remove this limitation.

Please refer to: [http://www.chip-community.org/index.php/Troubleshooting#Abrupt_Shutdowns Abrupt Shutdowns] for more information.

== Modify C.H.I.P. Power Limitations ==

The following steps and script is Copyrighted by Steven Ford http://geeky-boy.com/ and licensed "public domain style under [http://creativecommons.org/publicdomain/zero/1.0/ CC0].

If you are having power problems, you should first log into CHIP with all peripherals disconnected. These instructions assume you are in a shell prompt on CHIP.

'''Step 1.''' Get the shell script file onto CHIP:

sudo wget -O /etc/init.d/axp209-nolim <nowiki>http://fordsfords.github.io/axp209-nolim/axp209-nolim</nowiki>
 sudo chmod +x /etc/init.d/axp209-nolim
 sudo update-rc.d axp209-nolim defaults

'''Step 2.''' Now, do a graceful restart:

sudo shutdown -r now

For more information refer to: https://github.com/fordsfords/axp209-nolim

== GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) ==

This guide will assume you've already configured your CHIP's WiFi connection (by using the command: nmtui) and know it's IP address to be able to connect to it.

'''Step 1.''' Download and Istall GIMX

wget <nowiki>https://gimx.fr/download/gimx-raspbian</nowiki> -O gimx.deb
 sudo dpkg -i gimx.deb
 sudo apt-get -f install

'''Step 2.''' Stop & Disable Console TTY (make sure u are connected through SSH)
sudo systemctl mask serial-getty@ttyS0.service
sudo systemctl stop serial-getty@ttyS0.service

'''Step 3.''' Create GIMX directories
mkdir .gimx; mkdir .gimx/macros; mkdir .gimx/config

'''Step 4.''' Download and move the Configurations
wget https://github.com/matlo/GIMX-configurations/archive/master.zip

unzip master.zip
cd GIMX-configurations-master
cd Linux
mv * ~/.gimx/config
cd ~

'''Step 5.''' Delete the file master.zip and the directory GIMX-configurations-master
rm master.zip
rm -rf GIMX-configurations-master

CHIP

2016-12-20T05:14:04Z

Cajuil: /* Modify C.H.I.P. Power Limitations */

== Power Limitations ==

C.H.I.P. is '''limited to 900mA''' by default thus connecting an USB HUB or any other Periphal that requires more than that will make the device to abruptly '''turn off'''.

At the time of this writing, version 4.4 No-limit won't be enough. You'll have to make changes in the system to remove this limitation.

Please refer to: [http://www.chip-community.org/index.php/Troubleshooting#Abrupt_Shutdowns Abrupt Shutdowns] for more information.

== Modify C.H.I.P. Power Limitations ==

The following steps and script is Copyrighted by Steven Ford http://geeky-boy.com/ and licensed "public domain style under [http://creativecommons.org/publicdomain/zero/1.0/ CC0].

If you are having power problems, you should first log into CHIP with all peripherals disconnected. These instructions assume you are in a shell prompt on CHIP.

'''Step 1.''' Get the shell script file onto CHIP:

sudo wget -O /etc/init.d/axp209-nolim <nowiki>http://fordsfords.github.io/axp209-nolim/axp209-nolim</nowiki>
 sudo chmod +x /etc/init.d/axp209-nolim
 sudo update-rc.d axp209-nolim defaults

'''Step 2.''' Now, do a graceful restart:

For more information refer to: https://github.com/fordsfords/axp209-nolim

sudo shutdown -r now

== GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) ==

This guide will assume you've already configured your CHIP's WiFi connection (by using the command: nmtui) and know it's IP address to be able to connect to it.

'''Step 1.''' Download and Istall GIMX

wget <nowiki>https://gimx.fr/download/gimx-raspbian</nowiki> -O gimx.deb
 sudo dpkg -i gimx.deb
 sudo apt-get -f install

'''Step 2.''' Stop & Disable Console TTY (make sure u are connected through SSH)
sudo systemctl mask serial-getty@ttyS0.service
sudo systemctl stop serial-getty@ttyS0.service

'''Step 3.''' Create GIMX directories
mkdir .gimx; mkdir .gimx/macros; mkdir .gimx/config

'''Step 4.''' Download and move the Configurations
wget https://github.com/matlo/GIMX-configurations/archive/master.zip

unzip master.zip
cd GIMX-configurations-master
cd Linux
mv * ~/.gimx/config
cd ~

'''Step 5.''' Delete the file master.zip and the directory GIMX-configurations-master
rm master.zip
rm -rf GIMX-configurations-master

CHIP

2016-12-20T05:13:18Z

Cajuil: /* GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) */

== Power Limitations ==

C.H.I.P. is '''limited to 900mA''' by default thus connecting an USB HUB or any other Periphal that requires more than that will make the device to abruptly '''turn off'''.

At the time of this writing, version 4.4 No-limit won't be enough. You'll have to make changes in the system to remove this limitation.

Please refer to: [http://www.chip-community.org/index.php/Troubleshooting#Abrupt_Shutdowns Abrupt Shutdowns] for more information.

== Modify C.H.I.P. Power Limitations ==

The following steps and script is Copyrighted by Steven Ford [http://geeky-boy.com/] and licensed "public domain style under [http://creativecommons.org/publicdomain/zero/1.0/ CC0].

If you are having power problems, you should first log into CHIP with all peripherals disconnected. These instructions assume you are in a shell prompt on CHIP.

'''Step 1.''' Get the shell script file onto CHIP:

sudo wget -O /etc/init.d/axp209-nolim <nowiki>http://fordsfords.github.io/axp209-nolim/axp209-nolim</nowiki>
 sudo chmod +x /etc/init.d/axp209-nolim
 sudo update-rc.d axp209-nolim defaults

'''Step 2.''' Now, do a graceful restart:

For more information refer to: [https://github.com/fordsfords/axp209-nolim]

sudo shutdown -r now

== GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) ==

This guide will assume you've already configured your CHIP's WiFi connection (by using the command: nmtui) and know it's IP address to be able to connect to it.

'''Step 1.''' Download and Istall GIMX

wget <nowiki>https://gimx.fr/download/gimx-raspbian</nowiki> -O gimx.deb
 sudo dpkg -i gimx.deb
 sudo apt-get -f install

'''Step 2.''' Stop & Disable Console TTY (make sure u are connected through SSH)
sudo systemctl mask serial-getty@ttyS0.service
sudo systemctl stop serial-getty@ttyS0.service

'''Step 3.''' Create GIMX directories
mkdir .gimx; mkdir .gimx/macros; mkdir .gimx/config

'''Step 4.''' Download and move the Configurations
wget https://github.com/matlo/GIMX-configurations/archive/master.zip

unzip master.zip
cd GIMX-configurations-master
cd Linux
mv * ~/.gimx/config
cd ~

'''Step 5.''' Delete the file master.zip and the directory GIMX-configurations-master
rm master.zip
rm -rf GIMX-configurations-master

CHIP

2016-12-20T05:08:00Z

Cajuil: /* GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) */

CHIP

2016-12-20T05:07:24Z

Cajuil: /* GIMX on CHIP (tags: Next Thing Co. C.H.I.P.) */

CHIP

2016-12-20T05:06:53Z

Cajuil:

CHIP

2016-12-20T05:05:08Z

Cajuil: Created page with " == Power Limitations == C.H.I.P. is '''limited to 900mA''' by default thus connecting an USB HUB or any other Periphal that requires more than that will make the device to a..."

Main Page Old

2016-12-20T04:52:24Z

Cajuil:

<languages />
<translate>
Welcome to the GIMX wiki! 
Feel free to create an account and contribute! 
Check [[Translate|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 [http://www.raspberrypi.org/ 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|Features page]].


Compatibility issues are listed on the [[Compatibility|Compatibility page]].


The source code of GIMX is available under the [https://www.gnu.org/copyleft/gpl.html GPLv3] [https://gimx.fr/source here].


There's also a [https://blog.gimx.fr/ blog] with a few posts about the GIMX development, and a [https://forum.gimx.fr support forum].


To contribute to GIMX, see the [[Contribute|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 [https://en.wikipedia.org/wiki/Raspberry_Pi Raspberry Pi] or Thin clients running a small Linux distro.


About Ubuntu and Raspbian: 
:The only supported versions are [http://releases.ubuntu.com/16.04/ Ubuntu 16.04] and [https://www.raspberrypi.org/downloads/raspbian/ Raspbian Jessie], to use with [https://gimx.fr/downloads latest GIMX]. 
:It's also possible to use Ubuntu derivates such as [http://www.linuxmint.com/download.php 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 [https://help.ubuntu.com/community/WindowsDualBoot 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 [http://www.pendrivelinux.com/universal-usb-installer-easy-as-1-2-3/ 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 [[Bluetooth_dongle|compatibility list]].
:For PS4 only:
:*A genuine DS4 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=====
:Using a specific [[DIY_USB_adapter|Do-It-Yourself USB adapter]], the following emulations are available:
:{{Firmwares/en}}
:{{Third_party_adapters}}
: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 DS4 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 [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. 

===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== 


'''[[Installation|Software installation]]'''


'''[[Quick_Start|Quick start]]'''


'''[[Config_Editors|Config editors]]'''


'''[[Axis_translation_parameters|Axis translation parameters]]'''


'''[[Mouse_Calibration|Mouse calibration]]'''


'''[[Mouse_tweaks|Mouse tweaks]]'''


'''[[Macros|Macros]]'''


'''[[DIY_USB_adapter|DIY USB adapter]]'''


'''[[DIY_USB_adapter_for_dummies|DIY USB adapter for dummies]]'''


'''[[Logitech_Wheels|Logitech force feedback wheels]]'''


'''[[RPi|Raspberry Pi setup hints]]'''


'''[[CHIP|C.H.I.P. Quick setup guide]]'''

==Troubleshooting== 


First make sure you have the latest GIMX version. 
Then look at the [[FAQ]] and the [https://gimx.fr/buglist bug list], see if your problem is already known, and if it's not, [https://gimx.fr/newissue report it]. 
If you think you may have misconfigured something, ask for help on the [https://gimx.fr/forum/viewforum.php?f=5 forum].

==Old tutorials== 


'''Translations'''


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


* [http://forum.gimx.fr/viewtopic.php?f=4&t=13 German (outdated)]
* [http://forum.gimx.fr/viewtopic.php?f=4&t=173 Spanish (outdated)]
* [http://forum.gimx.fr/viewtopic.php?f=4&t=34 Russian (outdated)]


'''Configuration & Calibration'''


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


* [http://forum.gimx.fr/viewtopic.php?f=4&t=39 English]

==GIMX "the hard way"== 


'''Running GIMX from the command line'''


* [[Command_line|Command line]]


'''Development'''


* [[Development_on_Linux|Linux]]
* [[Development_on_Windows|Windows]]
* [[GUI_translation|GUI translation]]
* [[GE|The GIMX Event library]]
* [[gasync|The gasync library (evolution of the GE library)]]
* [[Network_API|Network API]]
* [https://github.com/matlo/serialusb Use the DIY USB adapter as a cheap USB proxy (~$5)]
* [[Bbb_sniffer|Use a BeagleBone Black as cheap a USB proxy (~$50)]]
* Controller protocols:
** [http://eleccelerator.com/wiki/index.php?title=DualShock_3 Dualshock 3]
** [http://eleccelerator.com/wiki/index.php?title=DualShock_4 Dualshock 4]
** [[T300RS_PS4|T300RS PS4]]
** [[G27_PS3|G27 PS3]]
</translate>