Add-on:The TVDB v4: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(minor edits)
m (Addon-Bot Update)
 
(14 intermediate revisions by 3 users not shown)
Line 3: Line 3:
|provider-name=TVDB Team
|provider-name=TVDB Team
|ID=metadata.tvshows.thetvdb.com.v4.python
|ID=metadata.tvshows.thetvdb.com.v4.python
|latest-version=1.0.16
|latest-version=1.1.6
|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/matrix/metadata.tvshows.thetvdb.com.v4.python/media/icon.png}}
|icon url=http://mirrors.kodi.tv/addons/nexus/metadata.tvshows.thetvdb.com.v4.python/media/icon.png}}
 
 




Line 32: Line 30:


= Settings =
= Settings =
Scraper settings can be adjusted in two locations, each location having a different result. When adjusting the settings be mindful of where:
{{#lst:Add-on:The_Movie_Database_Python|ScraperSettings}}
 
 
 
== General ==
[[File:TVDBv4-Settings01.jpg|700px]]
 


;Settings>Add-ons>Information Providers>TV Shows
; Language
: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'''
: Set which language of metadata to scrape. If the selected language is not available for a TV show, it will fall back to English.
: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
; Season Type
:Changing settings at the source will affect that source only.
: See next section ''Flexible Orders''


; Gender
: Please provide the gender of the primary user of this information. TheTVDB collects basic demographic information that we anonymize and combine to track worldwide TV and movie popularity.  We provide this summarized information to partners in the entertainment space to help influence the production and licensing of content.


'''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.
; Birth Year
: Please provide the birth year of the primary user of this information. TheTVDB collects basic demographic information that we anonymize and combine to track worldwide TV and movie popularity.  We provide this summarized information to partners in the entertainment space to help influence the production and licensing of content.


; PIN
: Enter an optional TheTVDB subscriber PIN. Future extended functionality within this plugin may benefit from being a TheTVDB subscriber, which grants you a unique PIN to use within all of your TheTVDB-connected systems.  This is not required for the functionality most users would expect, but it does help support TheTVDB as a free resource.




== General ==
 
= Flexible Orders =
<gallery mode="packed" widths="500px" heights="293px">
<gallery mode="packed" widths="500px" heights="293px">
File:TVDBv4-Settings01.jpg|Image 1- General Settings
File:TVDBv4-Settings03.jpg|Image 1- Check Season Order Type at TheTVDB
File:TVDBv4-Settings02.jpg|Image 2- Season Order Type
File:TVDBv4-Settings01.jpg|Image 2- General Settings
File:TVDBv4-Settings03.jpg|Image 3- Matching Season Order Type at TheTVDB
File:TVDBv4-Settings02.jpg|Image 3- Season Order Type
</gallery>
</gallery>




; Language
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).
: Set which language of metadata to scrape. If the selected language is not available for a TV show, it will fall back to English.
 
TheTVDB allows for up to 6 different Orders as follows:


; Season Type
: Standard Orders
: 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)
:: * Default (Aired Order) - the primary order for the episodes of the TV show
: TheTVDB allows for up to 6 different Orders as follows:
:: * 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
::: * Default (Aired Order) - the primary order for the episodes of the TV show
:: * Alternate - The first available flexible order
::: * Absolute - Absolute ordering places all episodes in a single ordered season. This is generally used for anime.
:: * Regional - The second available flexible order
::: * DVD - Used if the DVD/Bluray release uses a different order to the default order
:: * Alternate DVD - The third available flexible order


:: Flexible Orders
To use one of the Flexible Orders:
::: * Alternate - The first available flexible order
# Locate the TV show at TheTVDB and confirm that Flexible Orders are available (image 1, items 1 &amp; 2.)
::: * Regional - The second available flexible order
# Select the preferred order (image 1, item 2.). The SxxEyy type numbering of your episode files must match the episode numbering of your chosen order.
::: * Alternate DVD - The third available flexible order
# Note the order name used by the API (image 1, item 3.)
: 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>.
# In the scraper settings select the ''Season Type'' setting, and select the correct API order (images 2 & 3). Change scraper settings using '''method 3''' detailed above in ''Settings''.
# Scrape as per normal.


:'''Note:''' Not all order types are available for each TV Show. Check the available orders for your show at TheTVDB
:'''Note:''' Not all order types are available for each TV Show. Check the available orders for your show at TheTVDB
; Gender
:
; Birth Year
:
; PIN
:




Line 93: Line 96:
; 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 by selecting ''Change content'' from the context menu.
: 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.




{{top}}
{{top}}
{{updated|19}}
{{updated|20}}


[[Category:Add-ons with license tag]]
[[Category:Add-ons with license tag]]
[[Category:All add-ons]]
[[Category:All add-ons]]
[[Category:Karellen]]
[[Category:Karellen]]
[[Category:Matrix]]
[[Category:Nexus]]
[[Category:TV scraper add-ons]]
[[Category:TV scraper add-ons]]
[[Category:Video library]]
[[Category:Video library]]
[[Category:Matrix add-on repository]]
[[Category:Matrix add-on repository]]
[[Category:Nexus add-on repository]]
[[Category:Nexus add-on repository]]

Latest revision as of 01:00, 2 September 2023

The TVDB v4
icon.png

See this add-on on the kodi.tv showcase

Author: TVDB Team

Type: TV information
Repo: Kodi.tv repo v20
Kodi.tv repo v19

License: GPL-3.0-or-later

Summary: Fetch TV show metadata from TheTVDB.com
Home icon grey.png   ▶ 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:

  1. Settings
  2. Add-ons
  3. Install from repository
  4. Information providers (v16 and higher)
  5. TV information
  6. The TVDB v4
  7. 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:


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

TVDBv4-Settings01.jpg


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
See next section Flexible Orders
Gender
Please provide the gender of the primary user of this information. TheTVDB collects basic demographic information that we anonymize and combine to track worldwide TV and movie popularity. We provide this summarized information to partners in the entertainment space to help influence the production and licensing of content.
Birth Year
Please provide the birth year of the primary user of this information. TheTVDB collects basic demographic information that we anonymize and combine to track worldwide TV and movie popularity. We provide this summarized information to partners in the entertainment space to help influence the production and licensing of content.
PIN
Enter an optional TheTVDB subscriber PIN. Future extended functionality within this plugin may benefit from being a TheTVDB subscriber, which grants you a unique PIN to use within all of your TheTVDB-connected systems. This is not required for the functionality most users would expect, but it does help support TheTVDB as a free resource.


Flexible 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).

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
Flexible Orders
* Alternate - The first available flexible order
* Regional - The second available flexible order
* Alternate DVD - The third available flexible order

To use one of the Flexible Orders:

  1. Locate the TV show at TheTVDB and confirm that Flexible Orders are available (image 1, items 1 & 2.)
  2. Select the preferred order (image 1, item 2.). The SxxEyy type numbering of your episode files must match the episode numbering of your chosen order.
  3. Note the order name used by the API (image 1, item 3.)
  4. In the scraper settings select the Season Type setting, and select the correct API order (images 2 & 3). Change scraper settings using method 3 detailed above in Settings.
  5. Scrape as per normal.
Note: Not all order types are available for each TV Show. Check the available orders for your show at TheTVDB


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