HOW-TO:Share button maps: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Add See Also and categories)
mNo edit summary
 
(3 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]]}}


 
<section begin="intro" />Kodi ships with button maps for a small number of controllers on each platform. If you would like your configuration to be included in a Kodi release, it needs to be included in the Joystick Support add-on.<section end="intro" />
{{future|17}}
 
 
<section begin="intro" />Kodi ships with button maps for a small number of controllers on each platform. If you would like your configuration to be included in a Kodi release, it needs to be included in [[Add-on:Joystick Support]].<section end="intro" />




== Creating button maps ==
== Creating button maps ==
Button maps are generated by the [[Add-on:Joystick Support|Joystick Support add-on]]. Follow the steps in [[HOW-TO:Configure controllers]]. It is best if you map multiple controller profiles for each of your controllers; see [[HOW-TO:Map multiple controllers]].
Button maps are generated by the Joystick Support add-on. Follow the steps in [[HOW-TO:Configure controllers]]. It is best if you map multiple controller profiles for each of your controllers; see [[HOW-TO:Map multiple controllers]].


You can find the generated button map in the [[userdata]] folder at:
You can find the generated button map in the [[userdata]] folder at:
Line 22: Line 18:




== Share via the [[Forum]] ==
== Share via the Forum ==
If you share outside of GitHub, '''please include the filename of the button map'''. A friendly developer will then create a pull request on GitHub for you.
If you share outside of GitHub, '''please include the filename of the button map'''. A friendly developer will then create a pull request on GitHub for you.


Line 35: Line 31:
[[Category:Gaming]]
[[Category:Gaming]]
[[Category:Manual]]
[[Category:Manual]]
[[Category:Remotes]]

Latest revision as of 02:51, 17 December 2020

Home icon grey.png   ▶ Remote controls
▶ Games
▶ Game controllers ▶ HOW-TO:Share button maps

Kodi ships with button maps for a small number of controllers on each platform. If you would like your configuration to be included in a Kodi release, it needs to be included in the Joystick Support add-on.


Creating button maps

Button maps are generated by the Joystick Support add-on. Follow the steps in HOW-TO:Configure controllers. It is best if you map multiple controller profiles for each of your controllers; see HOW-TO:Map multiple controllers.

You can find the generated button map in the userdata folder at:

.../userdata/addon_data/peripheral.joystick/resources/buttonmaps/xml/<driver name>/

The button map is an XML file. You can see all existing button maps in the GitHub repo.


Share via GitHub

This is the preferred method. Simply fork the repo, add the button map to the correct folder of the GitHub repo, and send a pull request to https://github.com/xbmc/peripheral.joystick.


Share via the Forum

If you share outside of GitHub, please include the filename of the button map. A friendly developer will then create a pull request on GitHub for you.

Until we add a thread/subforum for button maps, you can post in the Hardware subforum. Please upload your button map to a pastebin site like http://paste.ubuntu.com and post a link. If you post the XML directly then it clutters the forum, but we'll accept it anyway.


See also