XBMC Skinning Manual

From XBMC

Jump to: navigation, search

Development Add-on development Skinning XBMC Skinning Manual

Contents

[hide]

1 Anatomy of a Skin

2 Skin Themes

3 Includes

4 The Window XML Files

5 addon.xml

6 Windows

o 6.1 Window Structure

o 6.2 About the Window XML Files

o 6.3 Window Header

6.3.1 The Different Types of Controls

6.3.2 Adding Extra Windows

7 Controls

o 7.1 Label Control

7.1.1 Example

7.1.2 Auto Size Labels

7.1.3 Multi-Line Labels

7.1.4 Available Tags

o 7.2 See also

o 7.3 Fade Label Control

7.3.1 Example

7.3.2 Tag Descriptions

o 7.4 See also

o 7.5 Button Control

7.5.1 Example

7.5.2 Available Tags

o 7.6 See also

o 7.7 Multiselect Control

7.7.1 Example

7.7.2 Available Tags

o 7.8 See also

o 7.9 Image Control

7.9.1 Example

7.9.2 Image Size and Type Restrictions

7.9.2.1 Size

7.9.2.2 Formats

7.9.3 Available Tags and Attributes

o 7.10 See also

o 7.11 MultiImage Control

7.11.1 Example

7.11.2 Image Size and Type Restrictions

7.11.2.1 Formats

7.11.3 Available Tags and Attributes

o 7.12 See also

o 7.13 Radio button Control

7.13.1 Example

7.13.2 Available Tags

o 7.14 See also

o 7.15 Select button control

7.15.1 Example

7.15.2 Available Tags

o 7.16 See also

o 7.17 Toggle button control

7.17.1 Example

7.17.2 Available Tags

o 7.18 See also

o 7.19 Spin Control

7.19.1 Example

7.19.2 Available Tags

o 7.20 See also

o 7.21 Settings Spin Control

7.21.1 Example

7.21.2 Available Tags

o 7.22 See also

o 7.23 Slider Control

7.23.1 Example

7.23.2 Available Tags

o 7.24 See also

o 7.25 List Container

7.25.1 Example

7.25.2 Available Tags

o 7.26 See also

o 7.27 Wraplist Container

7.27.1 Example

7.27.2 Available Tags

o 7.28 See also

o 7.29 FixedList Container

7.29.1 Available Tags

o 7.30 See also

o 7.31 Panel Container

7.31.1 Example

7.31.2 Available Tags

o 7.32 See also

o 7.33 Progress Control

7.33.1 Example

7.33.2 Available Tags

o 7.34 See also

o 7.35 Text Box

7.35.1 Example

7.35.2 Available Tags

o 7.36 See also

o 7.37 RSS feed Control

o 7.38 RSS ticker settings

o 7.39 Technical documentation for skinners

7.39.1 RSS control

7.39.2 Available Tags and attributes

7.39.3 RssFeeds.xml

o 7.40 See also

o 7.41 Visualisation Control

7.41.1 Example

7.41.2 Available Tags

o 7.42 See also

o 7.43 Video Control

7.43.1 Example

7.43.2 Available Tags

o 7.44 See also

o 7.45 Mover Control

7.45.1 Example

7.45.2 Available Tags

o 7.46 See also

o 7.47 Resize Control

7.47.1 Example

7.47.2 Available Tags

o 7.48 See also

o 7.49 Edit Control

7.49.1 Example

7.49.2 Available Tags

o 7.50 See also

o 7.51 EPGGrid Control

7.51.1 Example

7.51.2 Available Tags

o 7.52 See also

o 7.53 Console Control

o 7.54 Checkmark Control

o 7.55 Extended List Control

8 Conditional_Visibility

o 8.1 How They Work

o 8.2 Conditional Visibility for Dialogs

o 8.3 List of Boolean Conditions

o 8.4 Combining Conditions

o 8.5 Specifying the Transition Animation

o 8.6 See also

9 Animating Your Skin

o 9.1 Window Animations

o 9.2 Control Animations

o 9.3 Format of Animation Tags

9.3.1 Types

9.3.2 Attributes

o 9.4 Examples

o 9.5 See also

10 Fonts

o 10.1 Format of the Font.xml File

o 10.2 Supported Font Types

10.2.1 True type Fonts

11 Apendix I: List of Windows

12 Apendix II: List of Boolean Conditions

o 12.1 See also

13 Apendix III: List of Info Labels

o 13.1 Container

o 13.2 Control

o 13.3 Fanart

o 13.4 Listitem

o 13.5 Musicpartymode labels

o 13.6 Network labels

o 13.7 Player labels

13.7.1 Music player

13.7.2 Video player

o 13.8 Playlist

o 13.9 PVR

o 13.10 Skin

o 13.11 Slideshow

o 13.12 System

o 13.13 System params

o 13.14 Visualisation

o 13.15 Weather labels

o 13.16 Window

o 13.17 Images Available in XBMC

o 13.18 See also

14 Apendix IV: List of Built In Functions

o 14.1 List of functions

15 Apendix V: List of Built In Controls

o 15.1 .xml files

15.1.1 AddonBrowser.xml

15.1.2 DialogAddonInfo.xml

15.1.3 DialogAddonSettings.xml

15.1.4 DialogAlbumInfo.xml

15.1.5 DialogBusy.xml

15.1.6 DialogButtonMenu.xml

15.1.7 DialogContentSettings.xml

15.1.8 DialogContextMenu.xml

15.1.9 DialogExtendedProgressBar.xml

15.1.10 DialogFavourites.xml

15.1.11 DialogFileStacking.xml

15.1.12 DialogGamePad.xml

15.1.13 DialogKaiToast.xml

15.1.14 DialogKaraokeSongSelector.xml

15.1.15 DialogKaraokeSongSelectorLarge.xml

15.1.16 DialogKeyboard.xml

15.1.17 DialogMediaFilter.xml

15.1.18 DialogMediaSource.xml

15.1.19 DialogMusicScan.xml

15.1.20 DialogMuteBug.xml

15.1.21 DialogNetworkSetup.xml

15.1.22 DialogNumeric.xml

15.1.23 DialogOK.xml

15.1.24 DialogPeripheralManager.xml

15.1.25 DialogPeripheralSettings.xml

15.1.26 DialogPictureInfo.xml

15.1.27 DialogProgress.xml

15.1.28 DialogPVRChannelManager.xml

15.1.29 DialogPVRChannelsOSD.xml

15.1.30 DialogPVRGroupManager.xml

15.1.31 DialogPVRGuideInfo.xml

15.1.32 DialogPVRGuideOSD.xml

15.1.33 DialogPVRGuideSearch.xml

15.1.34 DialogPVRRecordingInfo.xml

15.1.35 DialogPVRTimerSettings.xml

15.1.36 DialogSeekBar.xml

15.1.37 DialogSelect.xml

15.1.38 DialogSlider.xml

15.1.39 DialogSongInfo.xml

15.1.40 DialogTextViewer.xml

15.1.41 DialogVideoInfo.xml

15.1.42 DialogVideoScan.xml

15.1.43 DialogYesNo.xml

15.1.44 FileBrowser.xml

15.1.45 FileManager.xml

15.1.46 LockSettings.xml

15.1.47 LoginScreen.xml

15.1.48 MusicKaraokeLyrics.xml

15.1.49 MusicOSD.xml

15.1.50 MusicOverlay.xml

15.1.51 MusicVisualisation.xml

15.1.52 MyMusicNav.xml

15.1.53 MyMusicPlaylist.xml

15.1.54 MyMusicPlaylistEditor.xml

15.1.55 MyMusicSongs.xml

15.1.56 MyPics.xml

15.1.57 MyPrograms.xml

15.1.58 MyPVR.xml

15.1.59 MyVideo.xml (deprecated)

15.1.60 MyVideoNav.xml

15.1.61 MyVideoPlaylist.xml

15.1.62 MyWeather.xml

15.1.63 Pointer.xml

15.1.64 ProfileSettings.xml

15.1.65 Settings.xml

15.1.66 SettingsCategory.xml

15.1.67 SettingsProfile.xml

15.1.68 SettingsScreenCalibration.xml

15.1.69 SlideShow.xml

15.1.70 SettingsSystemInfo.xml

15.1.71 SmartPlaylistEditor.xml

15.1.72 SmartPlaylistRule.xml

15.1.73 VideoFullScreen.xml

15.1.74 VideoOSDBookmarks.xml

15.1.75 VideoOSDSettings.xml

15.1.76 VideoOverlay.xml

15.1.77 VisualisationPresetList.xml

o 15.2 See also

16 Apendix VI: List of Default Icons

o 16.1 Icons used in XBMC skins

16.1.1 Add-ons

16.1.2 Music

16.1.3 Videos

16.1.4 Generic

o 16.2 See also

XBMC includes a new GUI library written from scratch. This library allows you to skin/change

everything you see in XBMC, from the images, the sizes and positions of all controls, colours,

fonts, and text, through to altering navigation and even adding new functionality.

The skin system is quite complex, and this portion of the manual is dedicated to providing in

depth information on how it all works, along with tips to make the experience a little more

pleasant.

If you are just getting started with skinning XBMC, then it is suggested that the best way to learn

is by modifying one of the many existing skins that are available. The default skin, Confluence,

includes almost all the various tricks and features that make the XBMC skinning engine so

powerful, so is an ideal place to start. You may wish to start by having a look through the tutorial

section on skinning XBMC as well as the "Skinning XBMC" article, and try modifying a

window or two by adding a button, or altering the textures or layout.

1 Anatomy of a Skin

XBMC 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 XBMC 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 contain