HOW-TO:Modify joystick.xml - Revision history

Karellen at 00:32, 15 December 2020

2020-12-15T00:32:51Z

← Older revision		Revision as of 00:32, 15 December 2020
Line 89:		Line 89:
	* {{big\|'''[[HOW-TO:Configure controllers]]'''}}		* {{big\|'''[[HOW-TO:Configure controllers]]'''}}
	* {{big\|'''[[HOW-TO:Share button maps]]'''}}		* {{big\|'''[[HOW-TO:Share button maps]]'''}}



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

Garbear at 22:32, 21 October 2018

2018-10-21T22:32:07Z

← Older revision		Revision as of 22:32, 21 October 2018
Line 33:		Line 33:
	<keymap>		<keymap>
	<global>		<global>
	<joystick>		<joystick profile="game.controller.default">
	<a>Select</a>		<a>Select</a>
	<b>Back</b>		<b>Back</b>

Garbear: Remove "Krypton feature" notice

2018-10-05T20:42:35Z

Remove "Krypton feature" notice

← Older revision		Revision as of 20:42, 5 October 2018
Line 1:		Line 1:
	{{mininav\| [[Remote controls]] {{l2\| [[Games]] }} \| [[Game controllers]]}}		{{mininav\| [[Remote controls]] {{l2\| [[Games]] }} \| [[Game controllers]]}}

	~~{{future\|17}}~~

	<section begin="intro" />Actions in Kodi are defined by [[Keymap\|Keymaps]]. If you would like to change the actions for a [[Game controllers\|game controller]], you will need to edit your joystick.xml file.<section end="intro" />		<section begin="intro" />Actions in Kodi are defined by [[Keymap\|Keymaps]]. If you would like to change the actions for a [[Game controllers\|game controller]], you will need to edit your joystick.xml file.<section end="intro" />

Garbear: Add See also and categories

2017-02-10T08:11:51Z

Add See also and categories

← Older revision		Revision as of 08:11, 10 February 2017
Line 86:		Line 86:
	[...]		[...]
	</syntaxhighlight>		</syntaxhighlight>


			== See also ==
			* {{big\|'''[[HOW-TO:Configure controllers]]'''}}
			* {{big\|'''[[HOW-TO:Share button maps]]'''}}


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

Garbear: Update page

2017-02-02T02:43:03Z

Update page

← Older revision		Revision as of 02:43, 2 February 2017
Line 7:		Line 7:

	'''Note:''' [[Add-on:Keymap Editor]] does not work for controllers at this time.		'''Note:''' [[Add-on:Keymap Editor]] does not work for controllers at this time.


	== General configuration ==		== General configuration ==

	Controllers are configured in two separate locations~~. First, you must map your controller in the controller configuration utility. See [[HOW-TO~~:~~Configure controllers]]. This defines the physical layout of your controller.~~		Controllers are configured in two separate locations:

			* First, you must map your controller in the configuration utility (see [[HOW-TO:Configure controllers]])
			* Optionally, Kodi uses a [[Keymap]] named <tt>joystick.xml</tt> to define Kodi actions for each button

	~~Once the physical layout of the controller is set, Kodi uses a [[Keymap]] to define which Kodi actions each button does (joystick.xml). This guide describes how to modify the Keymap.~~

			This guide describes how to modify the Keymap.


			'''Note:''' <tt>joystick.xml</tt> defines actions for an Xbox 360 controller. See [[HOW-TO:Map multiple controllers]].

	~~'''Note:''' joystick.xml defines actions for an Xbox 360 controller. If you mapped a different controller profile, then joystick.xml will translate this to an Xbox 360 controller.~~

	== Location of joystick.xml ==		== Location of joystick.xml ==

	The file joystick.xml should be located with Kodi's other keymaps (see [[Keymap#Location of keymaps\|Location of keymaps]]). They keymap placed in the [[userdata]] folder will override the keymap shipped with Kodi.		The file joystick.xml should be located with Kodi's other keymaps (see [[Keymap#Location of keymaps\|Location of keymaps]]). They keymap placed in the [[userdata]] folder will override the keymap shipped with Kodi.


	== Structure ==		== Structure ==

	The structure is similar to Kodi's other keymaps:		The structure is similar to Kodi's other [[keymaps]]:

	<syntaxhighlight lang="xml" enclose="div">		<syntaxhighlight lang="xml" enclose="div">
Line 66:		Line 72:
	</keymap>		</keymap>
	</syntaxhighlight>		</syntaxhighlight>


	== Planned features ==		== Planned features ==

Garbear: Initial page

2017-01-31T16:02:55Z

Initial page

New page

{{mininav| [[Remote controls]] {{l2| [[Games]] }} | [[Game controllers]]}}

{{future|17}}

<section begin="intro" />Actions in Kodi are defined by [[Keymap|Keymaps]]. If you would like to change the actions for a [[Game controllers|game controller]], you will need to edit your joystick.xml file.<section end="intro" />

'''Note:''' [[Add-on:Keymap Editor]] does not work for controllers at this time.

== General configuration ==

Controllers are configured in two separate locations. First, you must map your controller in the controller configuration utility. See [[HOW-TO:Configure controllers]]. This defines the physical layout of your controller.

Once the physical layout of the controller is set, Kodi uses a [[Keymap]] to define which Kodi actions each button does (joystick.xml). This guide describes how to modify the Keymap.

'''Note:''' joystick.xml defines actions for an Xbox 360 controller. If you mapped a different controller profile, then joystick.xml will translate this to an Xbox 360 controller.

== Location of joystick.xml ==

The file joystick.xml should be located with Kodi's other keymaps (see [[Keymap#Location of keymaps|Location of keymaps]]). They keymap placed in the [[userdata]] folder will override the keymap shipped with Kodi.

== Structure ==

The structure is similar to Kodi's other keymaps:

<syntaxhighlight lang="xml" enclose="div">
<keymap>
<global>
<joystick>
<a>Select</a>
<b>Back</b>
<x>ContextMenu</x>
<y>FullScreen</y>
<start>ActivateWindow(PlayerControls)</start>
<back>PreviousMenu</back>
<guide>ActivateWindow(Home)</guide>
<up>Up</up>
<down>Down</down>
<right>Right</right>
<left>Left</left>
<leftthumb>Screenshot</leftthumb>
<rightthumb>ActivateWindow(ShutdownMenu)</rightthumb>
<lefttrigger>ScrollUp</lefttrigger>
<righttrigger>ScrollDown</righttrigger>
<leftbumper>ScrollUp</leftbumper>
<rightbumper>ScrollDown</rightbumper>
<leftstickleft>Left</leftstickleft>
<leftstickright>Right</leftstickright>
<leftstickup>Up</leftstickup>
<leftstickdown>Down</leftstickdown>
<rightstickleft>VolumeDown</rightstickleft>
<rightstickright>VolumeUp</rightstickright>
<rightstickup>VolumeUp</rightstickup>
<rightstickdown>VolumeDown</rightstickdown>
</joystick>
</global>

<Home>
[...]
</Home>

[...]

</keymap>
</syntaxhighlight>

== Planned features ==

In the future, it will be possible to define actions for holding buttons, similar to [[Keymap#Long-press|Long presses]]:

<syntaxhighlight lang="xml" enclose="div">
<keymap>
<global>
<joystick>
<a>Select</a>
<a holdtime="250">ContextMenu</a>
[...]
</syntaxhighlight>