Difference between revisions of "HOW-TO:Share button maps"

From Official Kodi Wiki
Jump to navigation Jump to search
m
 
(5 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 16: Line 12:


The button map is an XML file. You can see all existing button maps in the [https://github.com/xbmc/peripheral.joystick/tree/master/peripheral.joystick/resources/buttonmaps/xml GitHub repo].
The button map is an XML file. You can see all existing button maps in the [https://github.com/xbmc/peripheral.joystick/tree/master/peripheral.joystick/resources/buttonmaps/xml GitHub repo].


== Share via GitHub ==
== Share via GitHub ==
Line 21: 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.


Until we add a thread/subforum for button maps, you can post in the [http://forum.kodi.tv/forumdisplay.php?fid=112 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.
Until we add a thread/subforum for button maps, you can post in the [http://forum.kodi.tv/forumdisplay.php?fid=112 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 ==
* {{big|'''[[HOW-TO:Configure controllers]]'''}}
* {{big|'''[[HOW-TO:Modify joystick.xml]]'''}}
[[Category:Gaming]]
[[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.


1 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.


2 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.


3 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.


4 See also