Opening Windows and Dialogs

From Official Kodi Wiki
Jump to navigation Jump to search
Home icon grey.png   ▶ 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

Notes