Add-on:TMDb TV Shows: Difference between revisions
m (Addon-Bot Update) |
m (Addon-Bot Update) |
||
(36 intermediate revisions by 2 users not shown) | |||
Line 3: | Line 3: | ||
|provider-name=Team Kodi | |provider-name=Team Kodi | ||
|ID=metadata.tvshows.themoviedb.org.python | |ID=metadata.tvshows.themoviedb.org.python | ||
|latest-version=1. | |latest-version=1.6.5 | ||
|extension point=xbmc.metadata.scraper.tvshows | |extension point=xbmc.metadata.scraper.tvshows | ||
|provides= | |provides= | ||
Line 16: | Line 16: | ||
|Email= | |Email= | ||
|broken= | |broken= | ||
|icon url=http://mirrors.kodi.tv/addons/ | |icon url=http://mirrors.kodi.tv/addons/nexus/metadata.tvshows.themoviedb.org.python/resources/icon.png}} | ||
= Introduction = | = Introduction = | ||
The Movie Database Python scraper is developed and maintained by Team Kodi. It is written in Python and has proven to be more stable and reliable than the Regex based scrapers. | |||
TMDb TV Shows scraper accesses the following sites to scrape your TV Shows, seasons and episodes to populate your library: | TMDb TV Shows scraper accesses the following sites to scrape your TV Shows, seasons and episodes to populate your library: | ||
Line 40: | Line 40: | ||
<gallery mode="packed" widths="500px" heights="293px"> | <gallery mode="packed" widths="500px" heights="293px"> | ||
File:TMDb-TV-Shows-01.jpg|Image 1- If the correct TV show is not in the list, select '''Manual''' | File:TMDb-TV-Shows-01.jpg|Image 1- If the correct TV show is not in the list, select '''Manual''' | ||
File:TMDb-TV-Shows-02.jpg|Image 2- If using the '''TMDB ID''', enter it as shown using the '''tmdb/''' prefix | File:TMDb-TV-Shows-02.jpg|Image 2- If using the '''TMDB ID''', enter it as shown using the '''tmdb/''' prefix, then press OK | ||
File:TMDb-TV-Shows-03.jpg|Image 3- If using the '''TVDB ID''', enter it as shown using the '''tvdb/''' prefix | File:TMDb-TV-Shows-03.jpg|Image 3- If using the '''TVDB ID''', enter it as shown using the '''tvdb/''' prefix, then press OK | ||
File:TMDb-TV-Shows-04.jpg|Image 4- If using the '''IMDB ID''', enter it as shown | File:TMDb-TV-Shows-04.jpg|Image 4- If using the '''IMDB ID''', enter it as shown, then press OK | ||
File:TMDb-TV-Shows-05.jpg|Image 5- Select the correct TV Show from the list. | File:TMDb-TV-Shows-05.jpg|Image 5- Select the correct TV Show from the list. | ||
</gallery> | </gallery> | ||
Line 49: | Line 49: | ||
= Settings = | = Settings = | ||
{{#lst:Add-on:The_Movie_Database_Python|ScraperSettings}} | |||
Line 70: | Line 59: | ||
; Preferred certification country | ; Preferred certification country | ||
: | : Select which country Content Certification system (MPAA) to use. | ||
; Include certification prefix | ; Include certification prefix | ||
Line 81: | Line 70: | ||
: Use the original (untranslated) title when downloading metadata for a foreign film. | : Use the original (untranslated) title when downloading metadata for a foreign film. | ||
: For example the TV show ''[https://www.themoviedb.org/tv/71446-la-casa-de-papel Money Heist]'' is the English translated title. The original title of the TV show is '''La casa de papel'''. If you prefer the English translated title (or whichever language you have set in the scraper settings), then '''disable''' the setting. If you prefer the original languge title then '''enable''' the setting. | : For example the TV show ''[https://www.themoviedb.org/tv/71446-la-casa-de-papel Money Heist]'' is the English translated title. The original title of the TV show is '''La casa de papel'''. If you prefer the English translated title (or whichever language you have set in the scraper settings), then '''disable''' the setting. If you prefer the original languge title then '''enable''' the setting. | ||
; Add keywords as tags | |||
: Scrape [https://www.themoviedb.org/bible/movie/59f3b16d9251414f20000007 Keywords] from TMDB and add them as Tags in Kodi | |||
: Be aware that larger libraries may be flooded with thousands of tags in {{kodi}} | |||
; Categorize fanart with text as landscape | |||
: Fanart is 16x9 images with no text | |||
: Landscape are fanart images with text | |||
: With this setting enabled, 16:9 images with text are scraped as a Landscape image type. | |||
; Include country code with studio | |||
: When disabled the studio will be saved as ''HBO'' | |||
: When enabled, the studio will be saved as ''HBO (US)'' with the country of origin appended to the studio name. | |||
: If the skin uses '''[[Add-on:Studio_Icons_-_Coloured|Studio Icons]]''', enabling this setting may break the display of icons for many studios. | |||
; Enable Trailer | |||
: When enabled, will scrape links to online trailers. Only a link is scraped to the trailer. The trailer itself is not downloaded. | |||
; Addon Player | |||
: Choose which addon to use to play the trailer. | |||
Line 88: | Line 97: | ||
; Default rating from | ; Default rating from | ||
: Choose which | : Choose which rating to download and display as the default rating. Most skins displays only a single rating. Choices are TMDB, IMDB and Trakt. | ||
; Also add IMDB ratings | ; Also add IMDB ratings | ||
: | : Download IMDB ratings in addition to the default rating. If IMDB is selected as default above, this setting will be greyed out. | ||
; Also add Trakt.tv ratings | ; Also add Trakt.tv ratings | ||
: | : Download Trakt.tv ratings in addition to the default rating. If Trakt.tv is selected as default above, this setting will be greyed out. | ||
; Also add TMDB ratings | ; Also add TMDB ratings | ||
: | : Download TMDB ratings in addition to the default rating. If TMDB is selected as default above, this setting will be greyed out. | ||
== Fanart.tv == | == Fanart.tv == | ||
This section | This section controls artwork scraping from '''[https://fanart.tv/ fanart.tv]''' | ||
All artwork related settings are set in {{highlight|bordered=yes|[[Settings/Media/Videos#Artwork|Settings ▶ Media ▶ Videos]]}} in the '''Artwork''' section of the {{Kodi}} settings. Use these settings to modify which artwork types are downloaded. The default is to download all artwork types. | |||
[[File:TMDb-TV-Shows-10.jpg|700px|Image 9- Fanart.tv]] | |||
--- | |||
; Include art from fanart.tv | |||
: This setting is enabled by default which allows scraping of artwork from fanart.tv. | |||
: For those that prefer no extended artwork, disable this setting. Artwork will then be limited to ''Poster, fanart, landscape'' and ''clearlogo'' as provided by TheMovieDB, unless you have further adjusted the artwork settings in {{Kodi}}. | |||
; Client key (optional) | ; Client key (optional) | ||
: Enter your personal API key here if you have one. | : Enter your personal API key here if you have one. | ||
: A personal API key is not required to use these features. | : A personal API key is not required to use these features. | ||
: For more information on API keys, see '''[https://fanart.tv/personal-api-keys/ fanart.tv Personal API Key benefits]''' | |||
== Advanced == | |||
[[File:TMDb-TV-Shows-09.jpg|700px|Image 10- Advanced]] | |||
; | ; Verbose debug logging | ||
: | : Used to add additional logging to help fault find scraping issues. | ||
: The additional logging is detailed and not required for general scraping issues. Please do not enable this unless specifically requested. | |||
= Episode Orders = | |||
Some TV Shows are originally broadcast in one order (default order) but the order may be different when broadcasting in a different country (La Casa De Papel), or the DVD/Bluray release may have a different screening order (Firefly). | |||
TheMovieDB uses Episode Groups for additional episode orders. | |||
[[File: | To use one of the orders for scraping, follow the images below. Paste the address into a '''''[[NFO_files/Parsing|Parsing NFO file]]''''' then scrape. The Parsing NFO File will point the scraper to the listing. <ref>https://forum.kodi.tv/showthread.php?tid=338467&pid=2801494#pid2801494</ref> | ||
'''Note:''' When using episode groups, the numbering of your episode files (SxxEyy) must match the numbering of the order you have chosen to use. | |||
: | |||
<gallery mode="traditional" widths="500px" heights="283px"> | |||
File:EpisodeGroups01.jpg|Image 1- Accessing Episode Groups | |||
File:EpisodeGroups02.jpg|Image 2- Available Episode Groups | |||
File:EpisodeGroups03.jpg|Image 3- Select a Group, then copy the address for use in a '''''[[NFO_files/Parsing|Parsing NFO file]]'''''. | |||
</gallery> | |||
= References = | |||
<references /> | |||
Line 153: | Line 162: | ||
{{top}} | {{top}} | ||
{{updated|20}} | |||
[[Category:Add-ons with license tag]] | |||
[[Category:Add-ons with source tag]] | |||
[[Category:Add-ons with website tag]] | |||
[[Category:All add-ons]] | |||
[[Category:Karellen]] | [[Category:Karellen]] | ||
[[Category:Nexus]] | |||
[[Category:TV scraper add-ons]] | |||
[[Category:Leia add-on repository]] | |||
[[Category:Matrix add-on repository]] | |||
[[Category:Nexus add-on repository]] |
Latest revision as of 05:40, 11 May 2023
TMDb TV Shows | ||||||||||||||||
|
![]() |
![]() |
![]() |
![]() |
Need help with this add-on? See here. |
The Movie Database (TMDb) is a community built movie and TV database. Every piece of data has been added by our amazing community dating back to 2008. TMDb's strong international focus and breadth of data is largely unmatched and something we're incredibly proud of. Put simply, we live and breathe community and that's precisely what makes us different.
Installing
This add-on is installed from the Add-on browser located in Kodi as follows:
- Settings
- Add-ons
- Install from repository
- Information providers (v16 and higher)
- TV information
- TMDb TV Shows
- Install
Introduction
The Movie Database Python scraper is developed and maintained by Team Kodi. It is written in Python and has proven to be more stable and reliable than the Regex based scrapers.
TMDb TV Shows scraper accesses the following sites to scrape your TV Shows, seasons and episodes to populate your library:
- TheMovieDB - for metadata and some artwork
- fanart.tv - for artwork
- IMDB - for ratings
- Trakt.tv - for ratings
Search
If the scraper is unable to find the correct TV Show, you can perform a search using either the IMDB, TMDB or TVDB ID's. This may be a more convenient method than using a Parsing NFO file.
- To search by TMDB enter the prefix tmdb/ followed by the ID. eg tmdb/90027
- To search by TVDB enter the prefix tvdb/ followed by the ID. eg tvdb/365026
- To search by IMDB ID enter the ttxxxxxx ID directly without any prefix. eg tt0489974
Note: This method can only be used for the TV Show. It cannot be used to find episodes.
Settings
Scraper settings can be adjusted in three locations, each location having a different result. When adjusting the settings be mindful of where:
- 1. Kodi System Settings ▶ Add-ons ▶ Information Providers ▶ (Select Scraper)
- Scrapers are installed with default settings. Adjusting settings in this location sets the new default settings for your scraper. From this point on any source you change to use this scraper will use the new default settings. Existing sources are not changed
- If an existing source is already using this scraper, and you would like the new settings to take effect, change the source to use another scraper, save and answer no to updating the library. Then change the scraper back and the new default settings will be loaded for the source. See: Changing Scrapers
- Alternatively, use the next method.
- 2. Videos ▶ Files ▶ Source ▶ Context Menu ▶ Change Content ▶ Settings
- Changing settings at the source will affect that source only.
- 3. Videos ▶ Files ▶ Source ▶ Movie/TV Show folder ▶ Context Menu ▶ Change Content ▶ Settings
- Changing settings on the folder containing a movie or TV show will affect only that movie or TV show.
Note: Changing scraper settings does not change the metadata or artwork already in your library. Only items scraped after the setting changes will be affected.
General
- Preferred language
- Set which language of metadata to scrape
- Preferred certification country
- Select which country Content Certification system (MPAA) to use.
- Include certification prefix
- To display the appropriate Content Advisory Rating flags in your skin, the rating must be prefixed. Enable this setting and add the prefix in the next setting.
- Prefix
- Insert the required certification prefix here. If unsure, check with the skin author what the required prefix is for your chosen country.
- Keep Original Title
- Use the original (untranslated) title when downloading metadata for a foreign film.
- For example the TV show Money Heist is the English translated title. The original title of the TV show is La casa de papel. If you prefer the English translated title (or whichever language you have set in the scraper settings), then disable the setting. If you prefer the original languge title then enable the setting.
- Add keywords as tags
- Scrape Keywords from TMDB and add them as Tags in Kodi
- Be aware that larger libraries may be flooded with thousands of tags in Kodi
- Categorize fanart with text as landscape
- Fanart is 16x9 images with no text
- Landscape are fanart images with text
- With this setting enabled, 16:9 images with text are scraped as a Landscape image type.
- Include country code with studio
- When disabled the studio will be saved as HBO
- When enabled, the studio will be saved as HBO (US) with the country of origin appended to the studio name.
- If the skin uses Studio Icons, enabling this setting may break the display of icons for many studios.
- Enable Trailer
- When enabled, will scrape links to online trailers. Only a link is scraped to the trailer. The trailer itself is not downloaded.
- Addon Player
- Choose which addon to use to play the trailer.
Ratings
- Default rating from
- Choose which rating to download and display as the default rating. Most skins displays only a single rating. Choices are TMDB, IMDB and Trakt.
- Also add IMDB ratings
- Download IMDB ratings in addition to the default rating. If IMDB is selected as default above, this setting will be greyed out.
- Also add Trakt.tv ratings
- Download Trakt.tv ratings in addition to the default rating. If Trakt.tv is selected as default above, this setting will be greyed out.
- Also add TMDB ratings
- Download TMDB ratings in addition to the default rating. If TMDB is selected as default above, this setting will be greyed out.
Fanart.tv
This section controls artwork scraping from fanart.tv
All artwork related settings are set in Settings ▶ Media ▶ Videos in the Artwork section of the Kodi settings. Use these settings to modify which artwork types are downloaded. The default is to download all artwork types.
- Include art from fanart.tv
- This setting is enabled by default which allows scraping of artwork from fanart.tv.
- For those that prefer no extended artwork, disable this setting. Artwork will then be limited to Poster, fanart, landscape and clearlogo as provided by TheMovieDB, unless you have further adjusted the artwork settings in Kodi.
- Client key (optional)
- Enter your personal API key here if you have one.
- A personal API key is not required to use these features.
- For more information on API keys, see fanart.tv Personal API Key benefits
Advanced
- Verbose debug logging
- Used to add additional logging to help fault find scraping issues.
- The additional logging is detailed and not required for general scraping issues. Please do not enable this unless specifically requested.
Episode Orders
Some TV Shows are originally broadcast in one order (default order) but the order may be different when broadcasting in a different country (La Casa De Papel), or the DVD/Bluray release may have a different screening order (Firefly).
TheMovieDB uses Episode Groups for additional episode orders.
To use one of the orders for scraping, follow the images below. Paste the address into a Parsing NFO file then scrape. The Parsing NFO File will point the scraper to the listing. [1]
Note: When using episode groups, the numbering of your episode files (SxxEyy) must match the numbering of the order you have chosen to use.
Image 3- Select a Group, then copy the address for use in a Parsing NFO file.
References
Return to top |
---|