Opening Windows and Dialogs

Development

Add-on development

Opening Windows and Dialogs

You can use the ActivateWindow() Built In Function to open a certain Window.

This command can be assigned to a button in a skin or mapped to a key in your Keymap.

Example:

• This will take you directly to the settings section/window of xbmc:

ActivateWindow(Settings)

Some windows allow you to jump directly to a sub-section of that window. To do this, you can use either the sub-section's name or its path.

Example:

• If you want a button in your skin or on your remote to take you directly to the movie listing, you let that button do:

ActivateWindow(Videos,MovieTitles)

or

ActivateWindow(Videos,videodb://movies/titles/)

Below is a list of the available sub-sections in the Videos, Music, and Programs sections/windows.

Videos

Sub-section Name	Path
Root	library://video/
Movies	videodb://movies/
MovieGenres	videodb://movies/genres/
MovieTitles	videodb://movies/titles/
MovieYears	videodb://movies/years/
MovieActors	videodb://movies/actors/
MovieDirectors	videodb://movies/directors/
MovieStudios	videodb://movies/studios/
MovieSets	videodb://movies/sets/
MovieCountries	videodb://movies/countries/
MovieTags	videodb://movies/tags/
RecentlyAddedMovies	videodb://recentlyaddedmovies/
TvShows	videodb://tvshows/
TvShowGenres	videodb://tvshows/genres/
TvShowTitles	videodb://tvshows/titles/
TvShowYears	videodb://tvshows/years/
TvShowActors	videodb://tvshows/actors/
TvShowStudios	videodb://tvshows/studios/
RecentlyAddedEpisodes	videodb://recentlyaddedepisodes/
InProgressTvShows	videodb://inprogresstvshows
MusicVideos	videodb://musicvideos/
MusicVideoGenres	videodb://musicvideos/genres/
MusicVideoTitles	videodb://musicvideos/titles/
MusicVideoYears	videodb://musicvideos/years/
MusicVideoArtists	videodb://musicvideos/artists/
MusicVideoAlbums	videodb://musicvideos/albums/
MusicVideoDirectors	videodb://musicvideos/directors/
MusicVideoStudios	videodb://musicvideos/studios/
RecentlyAddedMusicVideos	videodb://recentlyaddedmusicvideos/
Playlists	special://videoplaylists/
Current Playlist	playlistvideo://
Video Add-ons	addons://sources/video/
Files	sources://video/

Music

Sub-section Name	Path
Root	library://music/
Genres	musicdb://genres/
Artists	musicdb://artists/
Albums	musicdb://albums/
Song	musicdb://songs/
Top100	musicdb://top100/
Top100Songs	musicdb://top100/songs/
Top100Albums	musicdb://top100/albums/
RecentlyAddedAlbums	musicdb://recentlyaddedalbums/
RecentlyPlayedAlbums	musicdb://recentlyplayedalbums/
Compilations	musicdb://compilations/
Years	musicdb://years/
Singles	musicdb://singles/
Files	sources://music/
Playlists	special://musicplaylists/
Current Playlist	playlistmusic://
Music Add-ons	addons://sources/audio/

Programs

Sub-section Name	Path
Addons	addons://sources/executable/
AndroidApps	androidapp://sources/apps/

AddonBrowser

Sub-section Name	Path
My add-ons	addons://user/<type>/ (see for available types https://github.com/xbmc/xbmc/blob/master/xbmc/addons/Addon.cpp#L73)
Update available	addons://outdated/
Currently downloading add-ons	addons://downloading/
Recently updated	addons://recently_updated/
Install from repository	addons://repos/
Install from zip	addons://install/
Search	addons://search/

PVR

There are different PVR windows, one for every PVR content type (channels, recordings, timers, timer rules, search) not a single PVR window with sub sections denoting the different content types.

Currently, most PVR windows cannot be activated using user supplied paths. Support for more windows may be added in the future.

Example:

ActivateWindow(TVRecordings,pvr://recordings/tv/active/FooDirectory/)

will open the TV recordings window prepoulated with the recordings contained in directory FooDirectory.

Window Name	Path	Notes	Kodi version
TVChannels	pvr://channels/tv/<GROUPNAME>	Replace <GROUPNAME> with the name of the specific tv channel group	Kodi 19
TVGuide	pvr://channels/tv/<GROUPNAME>	Replace <GROUPNAME> with the name of the specific tv channel group	Kodi 19
TVRecordings	pvr://recordings/tv/active/<DIRECTORY>/	Replace <DIRECTORY> with the name of the recording directory to display
TVTimers
TVTimerRules
TVSearch
RadioChannels	pvr://channels/radio/<GROUPNAME>	Replace <GROUPNAME> with the name of the specific radio channel group	Kodi 19
RadioGuide	pvr://channels/radio/<GROUPNAME>	Replace <GROUPNAME> with the name of the specific radio channel group	Kodi 19
RadioRecordings	pvr://recordings/radio/active/<DIRECTORY>/	Replace <DIRECTORY> with the name of the recording directory to display
RadioTimers
RadioTimerRules
RadioSearch