HOW-TO:Configure controllers: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Add See Also and categories)
(→‎Configuring controllers: Re-arrange into a gallery)
Line 13: Line 13:
== Configuring controllers ==
== Configuring controllers ==


{{big|Kodi has a controller configuration utility to configure the physical layout of your controller. It can be found under system settings:}}
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]]
Under the Input category, find the "Configure attached controllers" item.


If this is greyed out, see [[Game controllers#Troubleshooting]].


{{big|Under the Input category, find the "Configure attached controllers" item:}}
Select the "Kodi" controller. You will be asked to press A.


[[File:Configure attached controllers.jpg]]
If you do nothing for 6 seconds, the prompt will be cancelled. You can start again at any button by selecting it.


{{big|If this is greyed out, see [[Game controllers#Troubleshooting]].}}
After mapping A, the utility will ask you to map B. This will continue until all buttons are mapped or the prompt times out.


If your controller doesn't have a button (like the Guide button), let the prompt time out and move on to the next button.


{{big|The controller configuration utility looks like this:}}
If you have a controller that looks different than the 360 controller, you can select "Get more..." to download additional controller profiles. For more info, see [[HOW-TO:Map multiple controllers]].


[[File:Controller configuration utility v17.jpg]]
For example, the SNES profile lets you map a SNES controller.


Kodi uses the "Kodi" profile. If you map this, it will override the SNES profile. To unmap the "Kodi" profile, select "Reset".


{{big|Select the "Kodi" controller. You will be asked to press A:}}
Remember that the A, B, X, and Y buttons on the SNES controller are physically reversed, so you may need to map both controllers if you want the alternative behavior.


[[File:Controller dialog - Press A.jpg]]
That's it! If you have problems, see [[Game controllers#Troubleshooting]].


{{big|If you do nothing for 6 seconds, the prompt will be cancelled. You can start again at any button by selecting it.}}


 
<gallery widths=360px heights=180px>
{{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:System settings.jpg
 
File:Configure attached controllers.jpg|Under the Input category, find the "Configure attached controllers" item
[[File:Controller dialog - Press B.jpg]]
File:Controller configuration utility v17.jpg
 
File:Controller dialog - Press A.jpg
 
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
 
File:Controller dialog - Get more.jpg
[[File:Controller dialog - Press Guide.jpg]]
File:Controller dialog - map SNES.jpg
 
File:Controller dialog - reset controller.jpg
 
</gallery>
{{big|If you have a controller that looks different than the 360 controller, you can select "Get more..." to download additional controller profiles. For more info, see [[HOW-TO:Map multiple controllers]].}}
 
[[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":}}
 
[[File:Controller dialog - reset controller.jpg]]
 
{{big|Remember that the A, B, X, and Y buttons on the SNES controller are physically reversed, so you may need to map both controllers if you want the alternative behavior.}}
 
 
{{big|That's it! If you have problems, see [[Game controllers#Troubleshooting]].}}




[[Category:Gaming]]
[[Category:Gaming]]


== See also ==
== See also ==

Revision as of 08:02, 10 February 2017

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


Future.png FUTURE Krypton FEATURE:
This page or section describes features that are a future part of the Kodi v17 release, codename "Krypton". For more information see development builds.


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

Kodi has a controller configuration utility to configure the physical layout of your controller. It can be found under system settings.

Under the Input category, find the "Configure attached controllers" item.

If this is greyed out, see Game controllers#Troubleshooting.

Select the "Kodi" controller. You will be asked to press A.

If you do nothing for 6 seconds, the prompt will be cancelled. You can start again at any button by selecting it.

After mapping A, the utility will ask you to map B. This will continue until all buttons are mapped or the prompt times out.

If your controller doesn't have a button (like the Guide button), let the prompt time out and move on to the next button.

If you have a controller that looks different than the 360 controller, you can select "Get more..." to download additional controller profiles. For more info, see HOW-TO:Map multiple controllers.

For example, the SNES profile lets you map a SNES controller.

Kodi uses the "Kodi" profile. If you map this, it will override the SNES profile. To unmap the "Kodi" profile, select "Reset".

Remember that the A, B, X, and Y buttons on the SNES controller are physically reversed, so you may need to map both controllers if you want the alternative behavior.

That's it! If you have problems, see Game controllers#Troubleshooting.


  • System settings.jpg
  • Under the Input category, find the "Configure attached controllers" item

    Under the Input category, find the "Configure attached controllers" item

  • Controller configuration utility v17.jpg
  • Controller dialog - Press A.jpg
  • Controller dialog - Press B.jpg
  • Controller dialog - Press Guide.jpg
  • Controller dialog - Get more.jpg
  • Controller dialog - map SNES.jpg
  • Controller dialog - reset controller.jpg

See also

Retrieved from "https://kodi.wiki/index.php?title=HOW-TO:Configure_controllers&oldid=127271"