Moltengamepad
Table of Contents generated with DocToc
This page details installation and usage of Moltengamepad on SteamOS
Moltengamepad (MG) is an input remapper that can create virtual input devices that forwards events from one or more source input devices (gamepads). In that sense, it is not unlike Steam's controller mapping.
Moltengamepad currently supports the following physical source input devices:
- WiiMotes (incl. accessories)
- Steam controllers
- JoyCons (rudimentary)
- Any generic input device via custom
gendevicemappings
Moltengamepad currently supports mapping events from these source input devices to the following virtual input devices:
- Generic Gamepad
- Xbox controller
- Keyboard
These virtual devices (number configurable) are created as soon as MG starts, so you can connect and disconnect some or all of your physical controllers on the fly. This also means, that there will be virtual input devices present even if you have no physical controller connected as long as MG is running.
The Moltengamepad documentation can be found at https://github.com/jgeumlek/MoltenGamepad
WiiMotes are modular and in reality a bunch of devices with different capabilities connected together. MG handles WiiMotes so that you can connect accessories like the Nunchuck or the Classic Controller on the fly, without the need to restart anything.
By default, a WiiMote (incl. all accessories) shows up as a generic gamepad and works pretty much as expected out of the box. The WiiMote core piece will always be in horizontal input mode. If you connect a Classic Controller, both the core piece and the Classic Controller will react to button presses.
To use a WiiMote you need to first pair it using the normal Bluetooth tools (Steam BPM's Bluetooth pairing tool or Gnome's Bluetooth control panel).
If you want to use your Steam controller to control keyboard/gamepad events just like you can do in Steam; but in a situation where the controller mapping of the Steam client is not available.
By default, a Steam Controller shows up as a generic gamepad and works pretty much like an Xbox controller out of the box. You will of course need the Steam Controller dongle connected in your machine for the Steam Controller to connect.
JoyCon support is rudimentary, but should be somewhat usable to utilise your JoyCon as a generic gamepad.
You want to build your own "monster controller" from several physical controllers that MG supports. Moltengamepad could combine them together into one virtual "monster controller" to be consumable by games and other software.
To accomplish this, you will need to write a custom mapping profile, check out the documentation at https://github.com/jgeumlek/MoltenGamepad
There is also an MG-Files repo with examples for profiles and gendevice mappings: https://github.com/jgeumlek/MG-Files
Install the moltengamepad package from the SteamOS Tools brewmaster main repository.
TBD
