HOW-TO:Configure controllers: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(creadit goes to garbear http://forum.kodi.tv/showthread.php?tid=252465)
 
mNo edit summary
 
(30 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Kodi Krypton features improved controller support. The old system required cumbersome log scanning and xml editing. Now, everything can be done from the GUI.
{{mininav| [[Remote controls]] {{l2| [[Games]] }} | [[Game controllers]]}}


Kodi is joining a large effort to automatically configure controllers for emulators (because let's face it, input configuration is [i]by far[/i] the worst experience of any emulator setup). Automatic configuration means you can plug in an N64 controller and have it work in a SNES game, automatically and without any input.
Since Kodi v17 (Krypton), Kodi now features an entirely new controller support system. Basic configuration can now be done from within the Kodi interface, without leaving the Kodi GUI.


If you'd like to help, you can share your button maps with the Kodi community. As we gather data from many users, this "votes" for your configuration, allowing it to potentially become the default for all Kodi users.
Currently, you can only configure the physical layout of your controller in Kodi. If you want to modify the actions that each button performs, see [[HOW-TO:Modify joystick.xml]].


[hr]
Kodi v17.0 has a bug where analog sticks can get "stuck" when they are first moved. This is fixed in v17.1. If this happens to you, see [[HOW-TO:Fix stuck analog sticks on v17.0]].


[size=large]First, find the controller window in System settings. It's well hidden.


== Configuring controllers ==
<gallery widths=360px heights=180px>
File:System settings.jpg|Enter Settings and open System settings
File:Configure attached controllers.jpg|Move to Input and select "Configure attached controllers"
File:Controller configuration utility v17.jpg|The controller-mapping window will open
File:Controller dialog - Press A.jpg|Press Select to start mapping
File:Controller dialog - Press B.jpg|For each item, press the button on your controller
File:Controller dialog - Press Guide.jpg|If a button (like Guide) is missing, let the prompt timeout and continue below
File:Controller dialog - Get more.jpg|You can configure controllers for different game systems
File:Controller dialog - map SNES.jpg|If you have a SNES controller, use the SNES profile
File:Controller dialog - reset controller.jpg|If you want to start over, select "Reset"
</gallery>


[img]https://imgur.com/PrD44S0.png[/img]


== See also ==
* {{big|'''[[HOW-TO:Modify joystick.xml]]'''}}
* {{big|'''[[HOW-TO:Share button maps]]'''}}


When you first launch the configuration utility, you will see something that looks like this:


 
[[Category:Gaming]]
[img]https://imgur.com/dpKb7yY.png[/img]
[[Category:Manual]]
 
[[Category:Remotes]]
 
(optional) The most interesting thing you can do here is to select "Get more...". This lets you install profiles of controllers for several game platforms.
 
 
[img]https://imgur.com/AehOE8u.png[/img]
 
 
When you've pimped out your install with every controller, it will look like this:
 
 
[img]https://imgur.com/WhGJ8MW.png[/img]
 
 
On the left is a list of controllers for several different platforms ("Kodi" will allow you to control Kodi).
 
On the right is a list of buttons belonging to each controller. When you select a different controller, the list updates to show its buttons.
 
The picture in the center gives a better idea of which buttons are which.
 
 
[img]https://imgur.com/6nJkm90.png[/img]
 
 
If the mapping process is not immediately evident, there is a help button in the bottom right.
 
 
[img]https://imgur.com/dcKo4YL.png[/img]
 
 
When you select a button, an instruction appears.
 
 
[img]https://imgur.com/nNhvQml.png[/img]
 
 
If your controller looks the same as the one on the screen, you should push the button on your controller that matches the button you see.
 
If your controller is radically different, you have two options.
 
[list]
[*] You can press the button that matches the physical location
[*] You can press the button that matches the game logic
[/list]
 
For example, a physical match would be the 360 controller's A and the SNES's B.
 
On the other hand, a logical match would be the 360 controller's A and the SNES's A.
 
If no button is pushed after a few seconds, the instruction will start counting down.
 
 
[img]https://imgur.com/VJDoIhE.png[/img]
 
 
When the countdown reaches zero, the prompt is aborted.
 
The prompt can also be aborted by pressing any key on the keyboard or remote that causes the button to lose focus.
 
When the wizard reaches the end of the list, the instructions are over and your controller is mapped.
 
 
[img]https://imgur.com/a8JhCD9.png[/img]

Latest revision as of 02:52, 17 December 2020

Home icon grey.png   ▶ Remote controls
▶ Games
▶ Game controllers ▶ HOW-TO:Configure controllers

Since Kodi v17 (Krypton), Kodi now features an entirely new controller support system. Basic configuration can now be done from within the Kodi interface, without leaving the Kodi GUI.

Currently, you can only configure the physical layout of your controller in Kodi. If you want to modify the actions that each button performs, see HOW-TO:Modify joystick.xml.

Kodi v17.0 has a bug where analog sticks can get "stuck" when they are first moved. This is fixed in v17.1. If this happens to you, see HOW-TO:Fix stuck analog sticks on v17.0.


Configuring controllers


See also