Lists Next Aired Calendar - jurialmunkey/plugin.video.themoviedb.helper GitHub Wiki
Next Aired Calendar
TMDbHelper provides lists to retrieve episodes airing on a certain day or within a certain range. These lists can be based off the library or the user's trakt account.
These lists are particularly useful if you want to create a Custom Skin Window as a replacement for the Next Aired script addon. Because TMDbHelper provides theses lists as plugin paths, there is greater flexibility in how you display these lists (unlike a scripted window which requires specific IDs and controls).
Available parameters
Param
Description
&startdate=
The number of days from today to start the range from. e.g. startdate=0 is Today, startdate=1 is Tomorrow. Accepts negative values e.g. startdate=-1 is from Yesterday and startdate=-7 is from one week ago.
&days=
The number of days to include in the range starting from the startdate. Any combination can be used to capture a specific range e.g. startdate=0&days=1 contains episodes airing today; startdate=1&days=1 contains episodes airing tomorrow; startdate=0&days=7contains episodes airing this week; startdate=-1&days=8contains episodes airing this week and also includes yesterday; startdate=-7&days=14contains episodes airing from last week AND this week; etc.
&user=false
Use with info=trakt_calendar to get ALL airing episodes not just the user's
&endpoint=premieres
Use with info=trakt_calendar to get ONLY season premieres
&endpoint=new
Use with info=trakt_calendar to get ONLY new tvshows
Special ListItem.Infolabels for Calendar episodes
Infolabel
Description
ListItem.Property(air_date)
Formatted air date using "Long date format" setting in Kodi Settings > Interface > Region >
ListItem.Property(air_time)
Formatted air time using "Time format" setting in Kodi Settings > Interface > Region >
ListItem.Property(air_day)
Formatted air day using "%A" e.g. "Monday" "Tuesday" etc.
ListItem.Property(air_day_short)
Formatted air day using "%a" e.g. "Mon" "Tues" etc.
ListItem.Property(air_date_short)
Formatted air date using "%d %b" e.g. "25-Oct" "05-Sep" etc.
ListItem.Year
Formatted air date using "%Y" e.g. "2021"
ListItem.Premiered
Formatted air date using "Short date format" setting in Kodi Settings > Interface > Region >
ListItem.Property(widget)
Contains information about the calendar list startdate and days setting. See below table for possible values
NOTE: By default a tvshow with multiple episodes airing on the same day will be "stacked" into a single item in the calendar. The following stacked_ properties are only available if the item has been stacked.
Infolabel
Description
ListItem.Property(stacked_count)
Number of episodes in the stack
ListItem.Property(stacked_labels)
Comma separated list of episode labels e.g. 5x01 - Ep1Title, 5x02 - Ep2Title, 5x03 - Ep3Title
ListItem.Property(stacked_titles)
Comma separated list of episode titles e.g. Ep1Title, Ep2Title, Ep3Title
ListItem.Property(stacked_episodes)
Comma separated lists of episode numbers e.g. 5x01, 5x02, 5x03
ListItem.Property(stacked_first)
First episode number in the stack e.g. 5x01
ListItem.Property(stacked_last)
Last episode number in the stack e.g. 5x03
ListItem.Property(stacked_first_episode)
First episode number in the stack without formatting e.g. 1
ListItem.Property(stacked_last_episode)
Last episode number in the stack without formatting e.g. 3
ListItem.Property(stacked_first_season)
First season number in the stack without formatting e.g. 5
ListItem.Property(stacked_last_season)
Last season number in the stack without formatting e.g. 5
ListItem.Property(widget)
This property contains a formatted label based upon the settings of the particular list. It is useful if you want to show a "heading" label for the list.