HOW-TO:Configure controllers: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Update guide for Estuary skin)
mNo edit summary
 
(16 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{mininav| [[Remote controls]] {{l2| [[Games]] }} | [[Game controllers]]}}
{{mininav| [[Remote controls]] {{l2| [[Games]] }} | [[Game controllers]]}}


{{future|17}}
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.


Kodi v17 Krypton features improved controller support. The [[HOW-TO:Modify joystick.xml|joystick keymaps]] have been simplified and basic configuration can now be done without leaving Kodi.
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]].


== Connecting controllers ==
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]].
 
{{big|Start by connecting your controllers. You should receive a notification like this:}}
 
[[File:Controller connected.jpg]]
 
{{big|If not, see [[Troubleshooting controllers]].}}




== Configuring controllers ==
== Configuring controllers ==
 
<gallery widths=360px heights=180px>
{{big|Kodi has a controller configuration utility to configure the physical layout of your controller. It can be found under system settings:}}
File:System settings.jpg|Enter Settings and open System settings
 
File:Configure attached controllers.jpg|Move to Input and select "Configure attached controllers"
[[File:System settings.jpg]]
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
{{big|Under the Input category, find the "Configure attached controllers" item:}}
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:Configure attached controllers.jpg]]
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"
{{big|If this is greyed out, see [[Troubleshooting controllers]].}}
</gallery>
 
 
{{big|The controller configuration utility looks like this:}}
 
[[File:Controller configuration utility v17.jpg]]
 
 
{{big|Select the "Kodi" controller. You will be asked to press A:}}
 
[[File:Controller dialog - Press A.jpg]]
 
{{big|If you do nothing for 6 seconds, the prompt will be cancelled. You can start again at any button by selecting it.}}
 
 
{{big|After mapping A, the utility will ask you to map B. This will continue until all buttons are mapped or the prompt times out.}}
 
[[File:Controller dialog - Press B.jpg]]
 
 
{{big|If your controller doesn't have a button (like the Guide button), let the prompt time out and move on to the next button}}
 
[[File:Controller dialog - Press Guide.jpg]]
 
 
{{big|If you have a controller that looks different than the 360 controller, you can select "Get more..." to download additional controller profiles:}}
 
[[File:Controller dialog - Get more.jpg]]
 
 
{{big|For example, the SNES profile lets you map a SNES controller:}}
 
[[File:Controller dialog - map SNES.jpg]]




{{big|Kodi uses the "Kodi" profile. If you map this, it will override the SNES profile. To unmap the "Kodi" profile, select "Reset":}}
== See also ==
* {{big|'''[[HOW-TO:Modify joystick.xml]]'''}}
* {{big|'''[[HOW-TO:Share button maps]]'''}}


[[File:Controller dialog - reset controller.jpg]]


[[Category:Gaming]]
[[Category:Gaming]]
[[Category:Manual]]
[[Category:Remotes]]

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