|
|
(21 intermediate revisions by the same user not shown)
|
| Line 1: |
Line 1: |
| | <languages /> | | <languages /> |
| − | Welcome on the GIMX wiki!<br /> | + | Welcome to the GIMX wiki!<br /> |
| − | Feel free to create an account and to 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. |
| | | | |
| − | The documentation is slowly moving from [http://gimx.fr/forum/viewforum.php?f=4 the forum], to this wiki.
| |
| | | | |
| − | ==About GIMX== | + | ==About GIMX==<!--T:13--> |
| | | | |
| | GIMX stands for Game Input MultipleXer or Game Input MatriX. The purpose of this software is to control a video game console with a PC. It works with the PS3 and there is experimental support for the Xbox 360. | | GIMX stands for Game Input MultipleXer or Game Input MatriX. The purpose of this software is to control a video game console with a PC. It works with the PS3 and there is experimental support for the Xbox 360. |
| Line 12: |
Line 11: |
| | It operates: | | It operates: |
| | * over bluetooth: works with Linux (PS3) only. A compatible bluetooth dongle is required. | | * over bluetooth: works with Linux (PS3) only. A compatible bluetooth dongle is required. |
| − | * over usb: works with Linux (PS3, 360) and Windows (PS3). A DIY USB adapter is required. | + | * over usb: works with Linux (PS3, 360) and Windows (PS3). A USB adapter is required. |
| | | | |
| − | The application gets data from the PC peripherals (mice, keyboards and joysticks) and sends controls to the PS3 over bluetooth or usb.<br/> | + | The application gets data from the PC peripherals (mice, keyboards and joysticks) and sends controls to the PS3 over bluetooth or usb.<br /> |
| | Other controls such as gesture or voice are possible through the use of external software that emulate PC peripherals. | | Other controls such as gesture or voice are possible through the use of external software that emulate PC peripherals. |
| | | | |
| | GIMX features are further described on the [[Features|Features page]]. | | GIMX features are further described on the [[Features|Features page]]. |
| | | | |
| − | The source code of GIMX is available under the [http://www.gnu.org/copyleft/gpl.html GPLv3] [http://code.google.com/p/diyps3controller/source/checkout there]. | + | Compatibility issues are listed on the [[Compatibility|Compatibility page]]. |
| | + | |
| | + | The source code of GIMX is available under the [http://www.gnu.org/copyleft/gpl.html GPLv3] [http://gimx.fr/source there]. |
| | | | |
| | There's also a [http://blog.gimx.fr/ blog] with a few posts about the GIMX development, and a [http://forum.gimx.fr support forum]. | | There's also a [http://blog.gimx.fr/ blog] with a few posts about the GIMX development, and a [http://forum.gimx.fr support forum]. |
| Line 27: |
Line 28: |
| | ==Hardware requirements== | | ==Hardware requirements== |
| | | | |
| − | '''PC'''<br/> | + | '''PC'''<br /> |
| − | GIMX is designed to run on a PC with Ubuntu or Windows. This is a strong requirement.<br/> | + | GIMX is designed to run on a PC with Ubuntu or Windows. This is a strong requirement.<br /> |
| − | GIMX can probably run with minor adaptations on smaller targets such as the Raspberry pi or Thin clients running a small Linux distro. | + | GIMX can run on smaller targets such as the [[RPi|Raspberry Pi]] or Thin clients running a small Linux distro. |
| | | | |
| − | About Ubuntu:<br/> | + | About Ubuntu:<br /> |
| − | :The currently supported version is [http://releases.ubuntu.com/11.10/ 11.10] (do not use version 12.04 for bluetooth, it makes GIMX lag).<br/> | + | :The currently supported versions are: |
| − | :Running GIMX in a virtual machine (vmware, virtualbox...) is NOT OFFICIALY supported (no help will be given for that).<br/> | + | :* [http://www.ubuntu.com/download/desktop latest Ubuntu] + [http://code.google.com/p/diyps3controller/downloads/list latest GIMX].<br /> |
| − | :It's possible to run Ubuntu from a live usb disk (nothing is saved on the hard drive).<br/> | + | :* [http://releases.ubuntu.com/11.10/ Ubuntu 11.10] + [http://code.google.com/p/diyps3controller/downloads/list?can=1&q=0.51 GIMX 0.51]: to be used for the bluetooth method in the case where there is latency with latest Ubuntu version.<br /> |
| − | :Feel free to install Ubuntu on your PC! 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.<br/> | + | :Running GIMX in a virtual machine (vmware, virtualbox...) is NOT OFFICIALY supported (no help will be given for that).<br /> |
| − | :Another way to use the 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]. | + | :It's possible to run Ubuntu from a live usb disk (nothing is saved on the hard drive).<br /> |
| | + | :Feel free to install Ubuntu on your PC! 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.<br /> |
| | + | :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]. |
| | | | |
| − | '''[[Bluetooth_dongle|Bluetooth dongle]]'''<br/> | + | '''Bluetooth dongle or USB adapter'''<br /> |
| − | GIMX can emulate a sixaxis using a bluetooth dongle or an internal bluetooth module.<br/> | + | ''Bluetooth dongle:''<br /> |
| − | This obviously only works with the PS3.<br/> | + | GIMX can emulate a sixaxis using a bluetooth dongle or an internal bluetooth module.<br /> |
| − | This doesn't work with Windows because there is no appropriate access to the bluetooth stack.<br/> | + | This obviously only works with the PS3.<br /> |
| − | While all bluetooth dongles/modules can't work with GIMX, working dongles are quite common.<br/> | + | This doesn't work with Windows because there is no appropriate access to the bluetooth stack.<br /> |
| | + | While all bluetooth dongles/modules can't work with GIMX, working dongles are quite common.<br /> |
| | Check the [[Bluetooth_dongle|compatibility list]]. | | Check the [[Bluetooth_dongle|compatibility list]]. |
| | | | |
| − | '''[[DIY_USB_adapter|Do-It-Yourself USB adapter]]'''<br/> | + | ''USB adapter:''<br /> |
| − | GIMX can emulate a joystick (for PS3) or a wired 360 pad, using a specific [[DIY_USB_adapter|Do-It-Yourself USB adapter]].<br/> | + | GIMX can also emulate a joystick (for PS3) or a wired 360 pad (Ubuntu/Linux only), using a specific [[DIY_USB_adapter|Do-It-Yourself USB adapter]].<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/> | + | It also can work with a [http://cronusdevice.com/ Cronus] (formerly known as GamepadProxy), which can emulate a wired sixaxis and a wired 360 pad.<br /> |
| − | For 360 only: a genuine wired 360 controller is required because the DIY USB adapter has to authenticate to the 360. | + | 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 only: a genuine wired 360 controller is required because the USB adapter has to authenticate to the 360. |
| | | | |
| − | '''Gaming mouse'''<br/> | + | '''Gaming mouse'''<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/> | + | 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 /> |
| − | Whereas a gaming mouse with more than 1600 DPI doesn't really make a difference on a PC, it's not the case with GIMX.<br/> | + | Whereas a gaming mouse with more than 1600 DPI doesn't really make a difference on a PC, it's not the case with GIMX.<br /> |
| − | GIMX can decelerate mouse movements so as to counteract the in-game acceleration.<br/> | + | GIMX can decelerate mouse movements so as to counteract the in-game acceleration.<br /> |
| | 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. |
| | | | |
| Line 64: |
Line 69: |
| | | | |
| | '''[[Config_Editors|Config editors]]''' | | '''[[Config_Editors|Config editors]]''' |
| | + | |
| | + | '''[[Calibration|Calibration]]''' |
| | | | |
| | '''[[Mouse_Calibration|Mouse calibration]]''' | | '''[[Mouse_Calibration|Mouse calibration]]''' |
| | + | |
| | + | '''[[Mouse_tweaks|Mouse tweaks]]''' |
| | | | |
| | '''[[Macros|Macros]]''' | | '''[[Macros|Macros]]''' |
| | + | |
| | + | '''[[DIY_USB_adapter|DIY USB adapter]]''' |
| | + | |
| | + | '''[[DIY_USB_adapter_for_dummies|DIY USB adapter for dummies]]''' |
| | | | |
| | ==Troubleshooting== | | ==Troubleshooting== |
| | | | |
| − | First make sure you have the latest GIMX version. | + | First make sure you have the latest GIMX version.<br /> |
| − | Then look at the [[FAQ]] and the [http://code.google.com/p/diyps3controller/issues/list?can=1&q=status%3AAccepted+OR+status%3AFixed bug list], see if your problem is already known, and if it's not, [http://code.google.com/p/diyps3controller/issues/entry report it]. | + | Then look at the [[FAQ]] and the [http://gimx.fr/buglist bug list], see if your problem is already known, and if it's not, [http://gimx.fr/newissue report it].<br /> |
| | + | If you think you may have misconfigured something, ask for help on the [http://gimx.fr/forum/viewforum.php?f=4 forum]. |
| | | | |
| | ==Old tutorials== | | ==Old tutorials== |
| | + | |
| | + | '''Translations''' |
| | | | |
| | The GIMX version in these tutorials is 0.24: they are outdated. | | The GIMX version in these tutorials is 0.24: they are outdated. |
| | | | |
| − | * [http://forum.gimx.fr/viewtopic.php?f=4&t=10 French (outdated)]
| |
| | * [http://forum.gimx.fr/viewtopic.php?f=4&t=13 German (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=173 Spanish (outdated)] |
| | * [http://forum.gimx.fr/viewtopic.php?f=4&t=34 Russian (outdated)] | | * [http://forum.gimx.fr/viewtopic.php?f=4&t=34 Russian (outdated)] |
| | | | |
| − | ==Configuration & Calibration==
| + | '''Configuration & Calibration''' |
| | | | |
| | This tutorial gives more details about how to adjust your configuration with gimx-config. | | This tutorial gives more details about how to adjust your configuration with gimx-config. |
| Line 89: |
Line 104: |
| | * [http://forum.gimx.fr/viewtopic.php?f=4&t=39 English] | | * [http://forum.gimx.fr/viewtopic.php?f=4&t=39 English] |
| | | | |
| − | ==Mouse polling rate== | + | ==GIMX "the hard way"== |
| − | | |
| − | This tutorial explains how to change the mouse polling rate in Ubuntu and Windows.
| |
| − | | |
| − | * [http://forum.gimx.fr/viewtopic.php?f=4&t=28 English]
| |
| − | | |
| − | ==DIY PC to PS3/360 USB adapter==
| |
| − | | |
| − | This page explains how to easily build an adapter.
| |
| − | | |
| − | * [http://forum.gimx.fr/viewtopic.php?f=4&t=405 English]
| |
| − | | |
| − | This page details all compatible hardware parts.
| |
| − | | |
| − | * [[DIY_USB_adapter|English]]
| |
| − | * [http://forum.gimx.fr/viewtopic.php?f=4&t=362 German]
| |
| | | | |
| − | ==Running GIMX from the command line==
| + | '''Running GIMX from the command line''' |
| | | | |
| − | * [[Command_line|English]] | + | * [[Command_line|Command line]] |
| | | | |
| − | ==Development==
| + | '''Development''' |
| | | | |
| | * [[Development_on_Linux|Linux]] | | * [[Development_on_Linux|Linux]] |
| | * [[Development_on_Windows|Windows]] | | * [[Development_on_Windows|Windows]] |
| | + | * [[GUI_translation|GUI translation]] |
| | + | * [[GE|The GIMX Event library]] |
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 software is to control a video game console with a PC. It works with the PS3 and there is experimental support for the Xbox 360.
It operates:
- over bluetooth: works with Linux (PS3) only. A compatible bluetooth dongle is required.
- over usb: works with Linux (PS3, 360) and Windows (PS3). A USB adapter is required.
The application gets data from the PC peripherals (mice, keyboards and joysticks) and sends controls to the PS3 over bluetooth or usb.
Other controls such as gesture or voice are possible through the use of external software that emulate PC 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 there.
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
PC
GIMX is designed to run on a PC with Ubuntu or Windows. 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:
- The currently supported versions are:
- 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 PC! 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.
Bluetooth dongle or USB adapter
Bluetooth dongle:
GIMX can emulate a sixaxis using a bluetooth dongle or an internal bluetooth module.
This obviously only works with the PS3.
This doesn't work with Windows because there is no appropriate access to the bluetooth stack.
While all bluetooth dongles/modules can't work with GIMX, working dongles are quite common.
Check the compatibility list.
USB adapter:
GIMX can also emulate a joystick (for PS3) or a wired 360 pad (Ubuntu/Linux only), using a specific Do-It-Yourself USB adapter.
It also can work with a Cronus (formerly known as GamepadProxy), which can emulate a wired sixaxis and a wired 360 pad.
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 only: a genuine wired 360 controller is required because the USB adapter has to authenticate to the 360.
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 PC, 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
Calibration
Mouse calibration
Mouse tweaks
Macros
DIY USB adapter
DIY USB adapter for dummies
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
