Add-on:The TVDB v4: Difference between revisions
m (Addon-Bot repo category update) |
(minor edits) |
||
Line 22: | Line 22: | ||
= Introduction = | = Introduction = | ||
TheTVDB v4 is the latest scraper developed by TheTVDB Team. It is written in Python and accesses the new v4 of the TheTVDB API. | |||
This scraper is intended to replace all other scrapers that currently utilise | This scraper is intended to replace all other scrapers that currently utilise TheTVDB site. It is expected that v1, v2 and v3 of TheTVDB API will be shutdown by then end of 2022, rendering the existing TheTVDB scrapers as broken. | ||
TheTVDB v4 scraper accesses the following site to scrape your TV Shows, seasons and episodes: | |||
* [https://thetvdb.com/ TheTVDB] - for metadata and artwork | * [https://thetvdb.com/ TheTVDB] - for metadata and artwork | ||
Line 63: | Line 63: | ||
:: Standard Orders | :: Standard Orders | ||
::: * Default (Aired Order) - the primary order for the episodes of the TV show | ::: * Default (Aired Order) - the primary order for the episodes of the TV show | ||
::: * Absolute - Absolute ordering places all episodes in a single ordered season. This is generally used for anime. | |||
::: * DVD - Used if the DVD/Bluray release uses a different order to the default order | ::: * DVD - Used if the DVD/Bluray release uses a different order to the default order | ||
:: Flexible Orders | :: Flexible Orders | ||
Line 70: | Line 70: | ||
::: * Regional - The second available flexible order | ::: * Regional - The second available flexible order | ||
::: * Alternate DVD - The third available flexible order | ::: * Alternate DVD - The third available flexible order | ||
: To use one of the Flexible Orders, select the Order Type in box 1 <small>(image 3)</small> and match the Order name in box 2 <small>(image 3)</small> with the Season Type in {{kodi}} <small>(image 2)</small>. | |||
:'''Note:''' Not all order types are available for each TV Show. Check the available orders for your show at TheTVDB | |||
; Gender | ; Gender | ||
Line 88: | Line 89: | ||
; No seasons or episodes are scraped, or are partially scraped | ; No seasons or episodes are scraped, or are partially scraped | ||
: Normally caused by setting an episode order in the scraper that is not available at | : Normally caused by setting an episode order in the scraper that is not available at TheTVDB. Check the Season Type setting, and select an order that is available at TheTVDB. | ||
; I mess up my scrape because I forget to change the Season Type from the previous scrape | ; I mess up my scrape because I forget to change the Season Type from the previous scrape | ||
: Leave the Source settings with the default settings, which you would use for most scrapes. For the shows requiring a different order, drill down to the TV show folder, and change the scraper setting for the individual TV show. | : Leave the Source settings with the default settings, which you would use for most scrapes. For the shows requiring a different order, drill down to the TV show folder, and change the scraper setting for the individual TV show by selecting ''Change content'' from the context menu. | ||
Revision as of 23:28, 10 May 2022
The TVDB v4 | ||||||||||||
|
Add-ons | The TVDB v4 |
TheTVDB.com is a TV Scraper. The site is a massive open database that can be modified by anybody and contains full meta data for many shows in different languages. All content and images on the site have been contributed by their users for users and have a high standard or quality. The database schema and website are open source under the GPL.
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
- The TVDB v4
- Install
Introduction
TheTVDB v4 is the latest scraper developed by TheTVDB Team. It is written in Python and accesses the new v4 of the TheTVDB API.
This scraper is intended to replace all other scrapers that currently utilise TheTVDB site. It is expected that v1, v2 and v3 of TheTVDB API will be shutdown by then end of 2022, rendering the existing TheTVDB scrapers as broken.
TheTVDB v4 scraper accesses the following site to scrape your TV Shows, seasons and episodes:
- TheTVDB - for metadata and artwork
Settings
Scraper settings can be adjusted in two locations, each location having a different result. When adjusting the settings be mindful of where:
- Settings>Add-ons>Information Providers>TV Shows
- 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. Alternatively, use the next method.
- Videos>Files>Source>Context Menu>Change Source>Settings
- Changing settings at the source will affect that source only.
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
- Language
- Set which language of metadata to scrape. If the selected language is not available for a TV show, it will fall back to English.
- Season Type
- TV Shows may have more than one order for seasons and episodes. eg, the DVD release may have a different order to original Aired Order. eg (Firefly, Money Heist)
- TheTVDB allows for up to 6 different Orders as follows:
- Standard Orders
- * Default (Aired Order) - the primary order for the episodes of the TV show
- * Absolute - Absolute ordering places all episodes in a single ordered season. This is generally used for anime.
- * DVD - Used if the DVD/Bluray release uses a different order to the default order
- Standard Orders
- Flexible Orders
- * Alternate - The first available flexible order
- * Regional - The second available flexible order
- * Alternate DVD - The third available flexible order
- Flexible Orders
- To use one of the Flexible Orders, select the Order Type in box 1 (image 3) and match the Order name in box 2 (image 3) with the Season Type in Kodi (image 2).
- Note: Not all order types are available for each TV Show. Check the available orders for your show at TheTVDB
- Gender
- Birth Year
- PIN
Troubleshooting
Having problems? Check these common problems and solutions
- No seasons or episodes are scraped, or are partially scraped
- Normally caused by setting an episode order in the scraper that is not available at TheTVDB. Check the Season Type setting, and select an order that is available at TheTVDB.
- I mess up my scrape because I forget to change the Season Type from the previous scrape
- Leave the Source settings with the default settings, which you would use for most scrapes. For the shows requiring a different order, drill down to the TV show folder, and change the scraper setting for the individual TV show by selecting Change content from the context menu.
Return to top |
---|