Video versions: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(First creation)
 
No edit summary
Line 4: Line 4:


= Introduction =
= Introduction =
Video Version is a new {{kodi}} feature introduced in v21. It allows users to keep multiple versions of the same movie in the library.
Video Version is a new {{kodi}} feature introduced in v21. It allows users to keep multiple versions of the same video title in the library.


Do you have the DVD, Bluray, 3D and 4K version of a movie?
Do you have the DVD, Bluray, 3D and 4K version of a title?
Do you have the Theatrical Release, Director's Cut, Extended version or any other type of version of a movie?
Do you have the Theatrical Release, Director's Cut, Extended version or any other type of version for the same title?
Do you dislike the same movie being repeatedly listed in the library?
Do you dislike the same title being repeatedly listed in the library?


All these different formats and versions can be scanned into the library, then attached to a parent title in the library. Think of it as Movie Sets for the same movie.
All these different formats and versions can be scanned into the library, then attached to a parent title in the library. Think of it as Movie Sets for the same movie.
Line 17: Line 17:


= Understanding Versions =
= Understanding Versions =
{{kodi}} uses a parent/child method for video versions. i.e. one movie is selected as the parent movie, which is the default movie, and other versions are added to this parent movie.
{{kodi}} uses a parent/child method for video versions. i.e. one version is selected as the parent version, which is the default version, and other versions are added to this parent version. The default version can be changed as required.


Using Blade Runner (1982) as an example, to make the original US Theatrical Release as the default movie, it would be selected as the movie to which all other versions are added to using the Manual method detailed below.
Using Blade Runner (1982) as an example, to make the original US Theatrical Release as the default version of the movie, it would be selected as the movie to which all other versions are added to.
<syntaxhighlight lang="xml"> -Blade Runner (1982) - US Theatrical Cut [dvd]          (parent movie; default movie)
<syntaxhighlight lang="xml"> -Blade Runner (1982) - US Theatrical Cut [dvd]          (parent movie; default movie)
     |- Blade Runner (1982) - Directors Cut [dvd]          (child version)
     |- Blade Runner (1982) - Directors Cut [dvd]          (child version)
Line 26: Line 26:
     |- Blade Runner (1982) - The Final Cut [dvd]          (child version)</syntaxhighlight>
     |- Blade Runner (1982) - The Final Cut [dvd]          (child version)</syntaxhighlight>


As this is a '''Library''' feature, the above has no effect on how the files are stored on your hard drives. Your movies can continue to be in their own folder, on different drives or in a single folder.
As this is a '''Library''' feature, the above has no effect on how the files are stored on your hard drives. Your video files can continue to be in their own folder, on different drives or in a single folder.




Versions are matched as follows:
Versions are matched as follows:
# The scanner first checks for duplicate TMDB or IMDB UniqueID
# The scanner first checks for duplicate TMDB or IMDB UniqueID
# If no ID is matched, then the scanner checks for a duplicate Title.
# If no ID is matched, then the scanner checks for a duplicate Title+Year.
To increase the accuracy of the scan, especially when using nfo files, ensure:
To increase the accuracy of the scan, especially when using nfo files, ensure:
# TMDB and IMDB ID's are included, correct and they are the same for all the versions
# TMDB and IMDB ID's are included, correct and they are the same for all the versions
# The value in the <title> tag is clean and that all the versions of the movie use the same title. i.e. Use <code><title>Blade Runner</title></code> instead of naming the version like <code><title>Blade Runner - US Theatrical Release</title></code>
# The value in the <title> tag is clean and that all the versions use the same title. i.e. Use <code><title>Blade Runner</title></code> instead of naming the version like <code><title>Blade Runner - US Theatrical Release</title></code>




Line 50: Line 50:
Settings ► Media ► Library ► Video Library ► '''Ignore different video versions on scan'''
Settings ► Media ► Library ► Video Library ► '''Ignore different video versions on scan'''


* '''Disabled''' - When an Update Library is run and the scanner discovers a movie that may be a duplicate of another movie already scanned into the library, the Update Library will pause with a pop-up requesting confirmation on how to treat the duplicate.
* '''Disabled''' - When an Update Library is run and the scanner discovers a title that may be a duplicate of another title already scanned into the library, the Update Library will pause with a pop-up requesting confirmation on how to treat the duplicate.
* '''Enabled''' - (default) When an Update Library is run, there are no interruptions to the scan and the various versions will be scanned or scraped into the library without a video version being created. Use the Manual method described below to create a Video Version after scanning has ended.
* '''Enabled''' - (default) When an Update Library is run, there are no interruptions to the scan and the various versions will be scanned or scraped into the library without a video version being created. Use the Manual method described below to create a Video Version after scanning has ended.
|}
|}
Line 64: Line 64:
Settings ► Media ► Videos ► All ► '''Select default video version'''
Settings ► Media ► Videos ► All ► '''Select default video version'''


* '''Disabled''' - (default) When selecting a video version movie to play, a pop-up will provide the option to select which version to play
* '''Disabled''' - (default) When selecting a video version to play, a pop-up will provide the option to select which version to play
* '''Enabled''' - Plays the default parent video. Other versions can be accessed from ''Context menu ► Choose version''
* '''Enabled''' - Plays the default parent video. Other versions can be accessed from ''Context menu ► Choose version''
|}
|}
Line 78: Line 78:
Settings ► Media ► Videos ► All ► '''Show videos with multiple versions as a folder'''
Settings ► Media ► Videos ► All ► '''Show videos with multiple versions as a folder'''


* '''Disabled''' - (default) When selecting a video version movie what happens after selection will be determined by the previous setting ''Select default video version''
* '''Disabled''' - (default) When selecting a video version, what happens after selection will be determined by the previous setting ''Select default video version''
* '''Enabled''' - Selecting a video with multiple versions will always open another screen listing the versions. Similar to opening a Movie Set.
* '''Enabled''' - Selecting a video with multiple versions will always open another screen listing the versions. Similar to opening a Movie Set.
|}
|}
Line 85: Line 85:


= Creating a Version =
= Creating a Version =
There are two methods to creating a Video Version. The Manual method allows control of which movie becomes the parent/default movie while the Library Update method allows no control for selecting which movie becomes parent/default.
There are two methods to creating a Video Version as detailed below. The methods can be used singly or in combination with each other.
 
For example, you may initially manually scan a single title, then run an Update Library to scan additional titles and using the pop-up notifications to create the Video Version, or vice versa.




Line 91: Line 93:
When using the Manual method, ensure:
When using the Manual method, ensure:
* The setting '''Ignore different video versions on scan''' is '''Enabled''', and
* The setting '''Ignore different video versions on scan''' is '''Enabled''', and
* All movies and versions are already scanned/scraped into the library.
* All video titles are already scanned/scraped into the library.


To create a Video Version, follow these steps.
To create a Video Version, follow these steps.


# Highlight the movie that will become the parent/default and call up the Context Menu
# Highlight the title that either currently is, or will become, the default version of the title and call up the Context Menu
# Select '''Manage ► Manage versions'''
# Select '''Manage ► Manage versions'''
# The pop-up box will display details of the parent movie. It defaults to "Standard Edition" but this can be changed using the '''Rename''' button
# The pop-up box will display details of the parent movie. It defaults to "Standard Edition" but this can be changed using the '''Rename''' button
# To add another version, select '''Add version'''
# To add another version, select '''Add version'''
# From the pop-up box, scroll to select the next movie to be added as a version and press ''Enter'' or equivelant keypress
#* If the message ''No similar movies were found in the library'' choose one of the following options:
#** '''Browse files'''- Browse your source folders to find another version of the movie. It will be scanned once selected
#** '''Browse library'''- Browse titles currently in the library and select the title from the library list.
#** '''Cancel'''- Cancel the operation
# From the pop-up box, scroll to select the next version to be added and press ''Enter'' or equivelant keypress
# From the next pop-up, select the version format. If a pre-defined name is not listed, add a new name using the ''New version...'' button
# From the next pop-up, select the version format. If a pre-defined name is not listed, add a new name using the ''New version...'' button
# The new version will be added
# The new version will be added
Line 108: Line 114:
When using the Manual method, ensure:
When using the Manual method, ensure:
* The setting '''Ignore different video versions on scan''' is '''Disabled'''
* The setting '''Ignore different video versions on scan''' is '''Disabled'''
{{kodi}} will scan titles into the library until it encounters a duplicate at which time the scanning pauses and requires a user response.


To create a Video Version, follow these steps.
To create a Video Version, follow these steps.


# Run the Update Library function, or navigate to your Source and from the context menu select ''Scan for new content''
# Run the Update Library function, or navigate to your Source and from the context menu select ''Scan for new content''
# When a movie is scanned that is a duplicate of a movie already in your library the ''Different movie version found'' dialogue will notify you
# When a title is scanned that is a duplicate of a title already in your library the ''Different movie version found'' dialogue will notify you
# Select '''Yes''' to add as a version or '''No''' to ignore and continue scanning
# Select '''Yes''' to add as a version or '''No''' to ignore and continue scanning
# When '''Yes''' is selected, the ''Add as a version to'' pop-up will offer the matching parent movie
# When '''Yes''' is selected, the ''Add as a version to'' pop-up will offer the matching parent title
# After selecting the parent movie, from the ''Choose version'' pop-up, select what type of version this movie is. If a pre-defined name is not listed, add a new name using the ''New version...'' button
# After selecting the parent title, from the ''Choose version'' pop-up, select what type of version this title is. If a pre-defined name is not listed, add a new name using the ''New version...'' button
# The Update Library scanner will continue with the scan until it finds another duplicate movie.
# The Update Library scanner will continue with the scan until it finds another duplicate movie.


Line 121: Line 129:


= Managing Versions =
= Managing Versions =
== Add New Version ==
== Remove a Version ==
== Change Default ==




Revision as of 23:08, 10 January 2024

Home icon grey.png   ▶ Video library ▶ Management ▶ Video versions


Introduction

Video Version is a new Kodi feature introduced in v21. It allows users to keep multiple versions of the same video title in the library.

Do you have the DVD, Bluray, 3D and 4K version of a title? Do you have the Theatrical Release, Director's Cut, Extended version or any other type of version for the same title? Do you dislike the same title being repeatedly listed in the library?

All these different formats and versions can be scanned into the library, then attached to a parent title in the library. Think of it as Movie Sets for the same movie.

This feature works on the movie library and may be expanded to TV shows and episodes in a later release of Kodi.


Understanding Versions

Kodi uses a parent/child method for video versions. i.e. one version is selected as the parent version, which is the default version, and other versions are added to this parent version. The default version can be changed as required.

Using Blade Runner (1982) as an example, to make the original US Theatrical Release as the default version of the movie, it would be selected as the movie to which all other versions are added to. 

 -Blade Runner (1982) - US Theatrical Cut [dvd]          (parent movie; default movie)
    |- Blade Runner (1982) - Directors Cut [dvd]           (child version)
    |- Blade Runner (1982) - Intl Theatrical Cut [dvd]     (child version)
    |- Blade Runner (1982) - The Final Cut [bluray]        (child version)
    |- Blade Runner (1982) - The Final Cut [dvd]           (child version)

As this is a Library feature, the above has no effect on how the files are stored on your hard drives. Your video files can continue to be in their own folder, on different drives or in a single folder.


Versions are matched as follows:

  1. The scanner first checks for duplicate TMDB or IMDB UniqueID
  2. If no ID is matched, then the scanner checks for a duplicate Title+Year.

To increase the accuracy of the scan, especially when using nfo files, ensure:

  1. TMDB and IMDB ID's are included, correct and they are the same for all the versions
  2. The value in the <title> tag is clean and that all the versions use the same title. i.e. Use <title>Blade Runner</title> instead of naming the version like <title>Blade Runner - US Theatrical Release</title>


Settings

There are three settings that control the behaviour of Video Versions.

Settings level: Basic
Description:

Settings ► Media ► Library ► Video Library ► Ignore different video versions on scan

  • Disabled - When an Update Library is run and the scanner discovers a title that may be a duplicate of another title already scanned into the library, the Update Library will pause with a pop-up requesting confirmation on how to treat the duplicate.
  • Enabled - (default) When an Update Library is run, there are no interruptions to the scan and the various versions will be scanned or scraped into the library without a video version being created. Use the Manual method described below to create a Video Version after scanning has ended.


Settings level: Standard
Description:

Settings ► Media ► Videos ► All ► Select default video version

  • Disabled - (default) When selecting a video version to play, a pop-up will provide the option to select which version to play
  • Enabled - Plays the default parent video. Other versions can be accessed from Context menu ► Choose version


Settings level: Standard
Description:

Settings ► Media ► Videos ► All ► Show videos with multiple versions as a folder

  • Disabled - (default) When selecting a video version, what happens after selection will be determined by the previous setting Select default video version
  • Enabled - Selecting a video with multiple versions will always open another screen listing the versions. Similar to opening a Movie Set.


Creating a Version

There are two methods to creating a Video Version as detailed below. The methods can be used singly or in combination with each other.

For example, you may initially manually scan a single title, then run an Update Library to scan additional titles and using the pop-up notifications to create the Video Version, or vice versa.


Manual

When using the Manual method, ensure:

  • The setting Ignore different video versions on scan is Enabled, and
  • All video titles are already scanned/scraped into the library.

To create a Video Version, follow these steps.

  1. Highlight the title that either currently is, or will become, the default version of the title and call up the Context Menu
  2. Select Manage ► Manage versions
  3. The pop-up box will display details of the parent movie. It defaults to "Standard Edition" but this can be changed using the Rename button
  4. To add another version, select Add version
    • If the message No similar movies were found in the library choose one of the following options:
      • Browse files- Browse your source folders to find another version of the movie. It will be scanned once selected
      • Browse library- Browse titles currently in the library and select the title from the library list.
      • Cancel- Cancel the operation
  5. From the pop-up box, scroll to select the next version to be added and press Enter or equivelant keypress
  6. From the next pop-up, select the version format. If a pre-defined name is not listed, add a new name using the New version... button
  7. The new version will be added
  8. To add additional versions, repeat these steps.


Library Update

When using the Manual method, ensure:

  • The setting Ignore different video versions on scan is Disabled

Kodi will scan titles into the library until it encounters a duplicate at which time the scanning pauses and requires a user response.

To create a Video Version, follow these steps.

  1. Run the Update Library function, or navigate to your Source and from the context menu select Scan for new content
  2. When a title is scanned that is a duplicate of a title already in your library the Different movie version found dialogue will notify you
  3. Select Yes to add as a version or No to ignore and continue scanning
  4. When Yes is selected, the Add as a version to pop-up will offer the matching parent title
  5. After selecting the parent title, from the Choose version pop-up, select what type of version this title is. If a pre-defined name is not listed, add a new name using the New version... button
  6. The Update Library scanner will continue with the scan until it finds another duplicate movie.


Managing Versions

Add New Version

Remove a Version

Change Default

Return to top


Retrieved from "https://kodi.wiki/index.php?title=Video_versions&oldid=249312"