Skin structure

From Official Kodi Wiki
Jump to: navigation, search
Home icon grey.png   ▶ Development ▶ Skin development ▶ Skin structure

Skin Structure


Kodi skins once installed are located in userdata addons folder. This is the folder where all skins are placed and listed.

Any additional skins you create, or download from or be installed via zip Kodi will load and ask you if you would like to load the skin and also allow you to load them up from within the Appearance Settings. It is suggested that if you want to make your own skin, then starting by copying an existing skins files over into a new folder (let's say skin/myskin) is a good place to start. You can then edit each of the files as you become more familiar with the skinning system.

Each skin folder contains several subdirectorys, and several files:

This is a resolution-specific directory. Kodi can run in multiple resolutions, and thus can use different files for some resolutions (as there is a big difference between NTSC at 720x480 pixels and 1080i at 1920x1080 pixels!)
optional folder containing the background images used in the skin
contains a defaults.xml file which is used to define the colours used in the skin
optional folder containing any additional items, that don't fit elsewhere
This subdirectory contains all fonts used by the skin. you can add/replace fonts here
contains several subfolders for each language (English/strings.po). you can define strings used in your skin in this file.
This subdirectory contains all the media files (.png/.gif/.jpg...) You can replace/edit these as you like.
place 10 screenshots (1280x720) of your skin in here. Name them screenshot-01.jpg, screenshot-02.jpg ect. NOTE: You will need to reference these using the asset tag in the addon.xml
This contains the information that Kodi uses to find the other files that Kodi requires to describe it's skin. It also contains credits information, and versioning information.
a textfile detailing what has changed in every version of the skin
a 1280x720 or 1920x1080 jpeg fanart image for your skin
a 256x256 or 512x512 png image for your skin
we recommend to include a Creative Commons license file in your skin:

See here for the order in which it looks for skin files.