TexturePacker - Revision history

Hitcher at 08:14, 12 April 2026

2026-04-12T08:14:21Z

← Older revision		Revision as of 08:14, 12 April 2026
Line 2:		Line 2:
	<section begin="intro" />Kodi uses a tool named TexturePacker to compile all images used in a skin into a single file. The benefit of it is that images inside the Textures.xbt will load faster in the skin. This is done by converting all images into a format that take less processing by Kodi when they need to be rendered onto the screen.		<section begin="intro" />Kodi uses a tool named TexturePacker to compile all images used in a skin into a single file. The benefit of it is that images inside the Textures.xbt will load faster in the skin. This is done by converting all images into a format that take less processing by Kodi when they need to be rendered onto the screen.

	A common misconception is that ~~TexturPacker~~ will just compress the images into a single file. This if far from the truth, so don't be surprised if the Textures.xbt file is much larger than the total size of all the individual images.		A common misconception is that TexturePacker will just compress the images into a single file. This if far from the truth, so don't be surprised if the Textures.xbt file is much larger than the total size of all the individual images.
	<section end="intro" />		<section end="intro" />
	== How To Get It ==		== How To Get It ==

Ronie: /* Usage */

2019-02-13T17:45:01Z

Usage

← Older revision		Revision as of 17:45, 13 February 2019
Line 28:		Line 28:

	If your skin includes [[Skin_development_introduction#Skin_Themes\|Skin Themes]] you should also run TexturePacker on your theme folders:		If your skin includes [[Skin_development_introduction#Skin_Themes\|Skin Themes]] you should also run TexturePacker on your theme folders:
	<pre>TexturePacker -input skin.name\themes\Blue -output skin.name\media\Blue.xbt</pre>		<pre>TexturePacker -dupecheck -input skin.name\themes\Blue -output skin.name\media\Blue.xbt</pre>

	{{Note\| When using an XBT file in your skin, your file paths will '''not''' be case sensitive, even if your skin resides on a case sensitive file system!}}		{{Note\| When using an XBT file in your skin, your file paths will '''not''' be case sensitive, even if your skin resides on a case sensitive file system!}}

Ronie: /* Advanced Usage - Texturepacker build bat */

2019-02-04T12:39:56Z

Advanced Usage - Texturepacker build bat

← Older revision		Revision as of 12:39, 4 February 2019
Line 65:		Line 65:
	ECHO.		ECHO.
	PING -n 2 -w 1000 127.0.0.1 > NUL		PING -n 2 -w 1000 127.0.0.1 > NUL
	START /B /WAIT TexturePacker -dupecheck -input media\ -output media\~~Texture~~.xbt		START /B /WAIT TexturePacker -dupecheck -input media\ -output media\Textures.xbt
	PING -n 2 -w 20000 127.0.0.1 > NUL		PING -n 2 -w 20000 127.0.0.1 > NUL
	ECHO.		ECHO.

Ronie: /* How To Get It */

2019-01-30T13:13:20Z

How To Get It

← Older revision		Revision as of 13:13, 30 January 2019
Line 18:		Line 18:

	{{Note\| TexturePacker depends on libgif which is currently not a ''Kodi'' dependency. Ensure the library and its development headers (Debian: libgif-dev package) is installed before compiling.}}		{{Note\| TexturePacker depends on libgif which is currently not a ''Kodi'' dependency. Ensure the library and its development headers (Debian: libgif-dev package) is installed before compiling.}}

			One you have downloaded/build TexturePacker, copy it to the kodi addons folder.

	== Usage ==		== Usage ==

Ronie: /* Usage */

2016-07-17T19:12:54Z

Usage

← Older revision		Revision as of 19:12, 17 July 2016
Line 25:		Line 25:
	The optional ''-dupecheck'' option is useful if you have included the same image multiple times in your media folder. For example, if your skin includes a lot of studio logos, most likely a lot of them are included multiple times but with a slightly different filename. The '-dupecheck' option will make sure each unique image is included only once in the Textures.xbt file, thus keeping the size of it as small as possible.		The optional ''-dupecheck'' option is useful if you have included the same image multiple times in your media folder. For example, if your skin includes a lot of studio logos, most likely a lot of them are included multiple times but with a slightly different filename. The '-dupecheck' option will make sure each unique image is included only once in the Textures.xbt file, thus keeping the size of it as small as possible.

	If your skin includes [[Skin_development_introduction#Skin_Themes]] you should also run TexturePacker on your theme folders:		If your skin includes [[Skin_development_introduction#Skin_Themes\|Skin Themes]] you should also run TexturePacker on your theme folders:
	<pre>TexturePacker -input skin.name\themes\Blue -output skin.name\media\Blue.xbt</pre>		<pre>TexturePacker -input skin.name\themes\Blue -output skin.name\media\Blue.xbt</pre>

Ronie at 19:09, 17 July 2016

2016-07-17T19:09:31Z

← Older revision		Revision as of 19:09, 17 July 2016
Line 33:		Line 33:
	Alternatively, you can use the [[TextureTool\|Kodi - Texture Tool]] which provides a Graphical User Interface for the same usage.		Alternatively, you can use the [[TextureTool\|Kodi - Texture Tool]] which provides a Graphical User Interface for the same usage.

	=== Texturepacker build bat ===		== Advanced Usage - Texturepacker build bat ==
			In case you want to automate the process and remove all the source images after the .xbt file has been compiled, you can optionaaly create a batch file with all needed commands.
	Create a Texturepacker.bat with the contents below, inside the skin.name directory along with all the texturepacker.exe, a double click on the bat file does all the work for you.		Create a Texturepacker.bat with the contents below, inside the skin.name directory along with all the texturepacker.exe, a double click on the bat file does all the work for you.
	<pre>		<pre>

Supp at 14:24, 1 June 2016

2016-06-01T14:24:24Z

← Older revision		Revision as of 14:24, 1 June 2016
Line 29:		Line 29:

	{{Note\| When using an XBT file in your skin, your file paths will '''not''' be case sensitive, even if your skin resides on a case sensitive file system!}}		{{Note\| When using an XBT file in your skin, your file paths will '''not''' be case sensitive, even if your skin resides on a case sensitive file system!}}


			Alternatively, you can use the [[TextureTool\|Kodi - Texture Tool]] which provides a Graphical User Interface for the same usage.

	=== Texturepacker build bat ===		=== Texturepacker build bat ===

Ronie: /* How To Get It */

2016-05-30T13:17:05Z

How To Get It

← Older revision		Revision as of 13:17, 30 May 2016
Line 6:		Line 6:
	== How To Get It ==		== How To Get It ==
	If you are using Windows, you can simply download a zipfile with an up-to-date version of TexturePacker from the Kodi mirrors.		If you are using Windows, you can simply download a zipfile with an up-to-date version of TexturePacker from the Kodi mirrors.
	<br /><big>'''It is available here:''' [http://mirrors.kodi.tv/build-deps/win32/texturepacker-1.1.0-win32.7z '''Download TexturePacker 1.1.0''']</big>		<br /><big>'''It is available here:''' [http://mirrors.kodi.tv/build-deps/win32/texturepacker-1.1.1-win32.7z '''Download TexturePacker 1.1.1''']</big>
	{{note\| This is a dll free self contained texturepacker executable for windows.}}		{{note\| This is a dll free self contained texturepacker executable for windows.}}
	{{note\| Kodi v17 does not support DXT packed textures anymore. Make sure you pack your skin textures with latest texturepacker (1.1.0 or newer).}}		{{note\| Kodi v17 does not support DXT packed textures anymore. Make sure you pack your skin textures with latest texturepacker (1.1.0 or newer).}}

Stefansaraev: /* How To Get It */

2016-02-14T17:51:08Z

How To Get It

← Older revision		Revision as of 17:51, 14 February 2016
Line 6:		Line 6:
	== How To Get It ==		== How To Get It ==
	If you are using Windows, you can simply download a zipfile with an up-to-date version of TexturePacker from the Kodi mirrors.		If you are using Windows, you can simply download a zipfile with an up-to-date version of TexturePacker from the Kodi mirrors.
	<br /><big>'''It is available here:''' [http://mirrors.kodi.tv/build-deps/win32/texturepacker-1.0.4-win32.7z '''Download TexturePacker 1.0.4''']</big>		<br /><big>'''It is available here:''' [http://mirrors.kodi.tv/build-deps/win32/texturepacker-1.1.0-win32.7z '''Download TexturePacker 1.1.0''']</big>
	{{note\| This is a dll free self contained texturepacker executable for windows.}}		{{note\| This is a dll free self contained texturepacker executable for windows.}}
			{{note\| Kodi v17 does not support DXT packed textures anymore. Make sure you pack your skin textures with latest texturepacker (1.1.0 or newer).}}

	On other platforms, you will have to compile TexturePacker. TexturePacker is built and stored in ../tools/depends/native/TexturePacker/bin during Kodi's configure process. Bootstrap and configure can be lengthy. If you only need TexturePacker, you can save some effort: install the Kodi source and build dependencies in preparation for a build ([http://kodi.wiki/view/Category:Compiling '''Compiling from source''']) and build TexturePacker directly:		On other platforms, you will have to compile TexturePacker. TexturePacker is built and stored in ../tools/depends/native/TexturePacker/bin during Kodi's configure process. Bootstrap and configure can be lengthy. If you only need TexturePacker, you can save some effort: install the Kodi source and build dependencies in preparation for a build ([http://kodi.wiki/view/Category:Compiling '''Compiling from source''']) and build TexturePacker directly:

Ronie: /* How To Get It */

2015-12-02T19:15:56Z

How To Get It

← Older revision		Revision as of 19:15, 2 December 2015
Line 6:		Line 6:
	== How To Get It ==		== How To Get It ==
	If you are using Windows, you can simply download a zipfile with an up-to-date version of TexturePacker from the Kodi mirrors.		If you are using Windows, you can simply download a zipfile with an up-to-date version of TexturePacker from the Kodi mirrors.
	<br /><big>'''It is available here:''' [http://mirrors.kodi.tv/build-deps//win32/texturepacker-1.0.4-win32.7z '''Download TexturePacker 1.0.4''']</big>		<br /><big>'''It is available here:''' [http://mirrors.kodi.tv/build-deps/win32/texturepacker-1.0.4-win32.7z '''Download TexturePacker 1.0.4''']</big>
	{{note\| This is a dll free self contained texturepacker executable for windows.}}		{{note\| This is a dll free self contained texturepacker executable for windows.}}