Video versions - Revision history

Karellen at 03:45, 19 August 2025

2025-08-19T03:45:12Z

← Older revision		Revision as of 03:45, 19 August 2025
Line 1:		Line 1:
	{{mininav\|[[Video library]]\|[[Video management\|Management]] }}		{{mininav\|[[Video library]]\|[[Video management\|Management]] }}

			{\|class="infobox" style="width:230px"
			! Versions Contents
			\|-
			\|
			'''[[Video_versions\|Video Versions]]'''<br>
			'''[[Video_extras\|Video Extras]]'''
			\|}

Karellen: Update label

2024-08-25T23:48:07Z

Update label

← Older revision		Revision as of 23:48, 25 August 2024
Line 100:		Line 100:

	# Access the Versions Manager		# Access the Versions Manager
	# 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 '''Choose Type''' button
	# To add another version, select '''Add version'''		# To add another version, select '''Add version'''
	#* If the message ''No similar movies were found in the library'' choose one of the following options:		#* If the message ''No similar movies were found in the library'' choose one of the following options:
Line 116:		Line 116:


	== ~~Rename~~ ==		== Choose Type ==
	Used to nominate the version type- i.e. ''Directors Cut, Extended Edition'' etc.		Used to nominate the version type- i.e. ''Directors Cut, Extended Edition'' etc.

	# Call up the Versions Manager		# Call up the Versions Manager
	# Scroll to the version to be renamed		# Scroll to the version to be renamed
	# Select ''~~Rename~~''		# Select ''Choose Type''
	# From the ''Choose version'' dialogue,		# From the ''Choose version'' dialogue,
	#* Select the required version		#* Select the required version

Karellen: Edit settings

2024-05-01T01:42:37Z

Edit settings

← Older revision		Revision as of 01:42, 1 May 2024
Line 45:		Line 45:
	{{#lst:Settings/Media/Library\|IgnoreVideoVersionsScan}}		{{#lst:Settings/Media/Library\|IgnoreVideoVersionsScan}}

			{{#lst:Settings/Media/Videos\|SelectDefaultVideoVersion}}

	{\|		{{#lst:Settings/Media/Videos\|ShowVideosWithMultipleVersionsAsFolder}}
	~~\|- valign="top"~~
	~~\| width=120px \|~~ {~~{nowrap\|'''Settings level:'''}}~~
	~~\| Standard~~
	~~\|- valign="top"~~
	~~\| '''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''
	\|}


	{\|
	~~\|- valign="top"~~
	~~\| width=120px \| {{nowrap\|'''Settings level:'''}}~~
	~~\| Standard~~
	~~\|- valign="top"~~
	~~\| '''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.
	\|}

Karellen at 01:00, 1 May 2024

2024-05-01T01:00:04Z

@@ Line 43: / Line 43: @@
 = Settings =
 There are three settings that control the behaviour of Video Versions.
+{{#lst:Settings/Media/Library|IgnoreVideoVersionsScan}}

Karellen: add nfo and other minor updates

2024-02-01T00:19:08Z

add nfo and other minor updates

← Older revision		Revision as of 00:19, 1 February 2024
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 video title in the library.		<section begin="intro" />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 DVD, Bluray, 3D and 4K version of a title?
Line 10:		Line 10:
	Do you dislike the same title 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 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 attached to a parent title in the library. Think of it as Movie Sets for the same movie.<section end="intro" />

	This feature works on the movie library and may be expanded to TV shows and episodes in a later release of {{kodi}}.		This feature works on the movie library and may be expanded to TV shows and episodes in a later release of {{kodi}}.
Line 93:		Line 93:


	'''Note:''' During initial creation of a Video Version collection, the parent/default version needs to be scanned/scraped into the library (but changing via ''Set as default'' does not need scraping again). Child titles do not need to be scanned into the library as any metadata that is scanned/scraped is discarded once the title is added as a child version. Using the ''Browse files'' option in the Versions Manager method, a video file can be directly linked to a Version collection without scanning. Child versions always use the metadata of the parent title.		'''Note:''' During initial creation of a Video Version collection, the parent/default version needs to be scanned/scraped into the library (but changing via ''Set as default'' does not need scraping again). Child titles do not need to be scanned into the library as any metadata that is scanned/scraped is discarded once the title is added as a child version. Using the ''Browse files'' option in the Versions Manager method, a video file can be directly linked to a Version collection without scanning. Child versions always use the metadata of the parent title. The only downside to this method is if you have unique artwork for each version, this will not be scanned and artwork from the parent version will be used.


Line 152:		Line 152:


	== Rename ~~Version Types~~ ==		== Rename ==
	Used to nominate the version type- i.e. ''Directors Cut, Extended Edition'' etc.		Used to nominate the version type- i.e. ''Directors Cut, Extended Edition'' etc.

Line 163:		Line 163:


	== Remove ~~a Version~~ ==		== Remove ==
	The only method that allows removal of individual child versions is the ''Remove Child Version'' method described in this section. Any other method you may use will remove the entire Version collection.		The only method that allows removal of individual child versions is the ''Remove Child Version'' method described in this section. Any other method you may use will remove the entire Version collection.

			''Remove'' will remove a version from the library only and will not delete files from the file system. The setting '''[[Settings/Media/General#Allow_file_renaming_and_deletion\| Allow file renaming and deletion]]''' has no effect. Be aware that running an Update Library will rescan the removed title back into the library.

	=== Remove Version Collection ===		=== Remove Version Collection ===
Line 190:		Line 192:


	== ~~Change~~ Default ==		== Set As Default ==
	The default title allows immediate playback, instead of browsing for a version, when the setting '''Select default video version''' is enabled.		The default title allows immediate playback, instead of browsing for a version, when the setting '''Select default video version''' is enabled.

Line 198:		Line 200:
	# Highlight the version to be made as the new default version		# Highlight the version to be made as the new default version
	# Select ''Set as default''		# Select ''Set as default''



			= NFO Files =
			{{note\| NFO file support is an incomplete feature in v21. Plans are to complete the feature in v22.}}

			Exporting the library to ''Separate Files'' now exports the following Video Versions related xml tags:

			<syntaxhighlight lang="xml">
			<videoassettitle>Intl Theatrical Cut</videoassettitle>
			<videoassetid>40801</videoassetid>
			<videoassettype>0</videoassettype>
			<hasvideoversions>true</hasvideoversions>
			<hasvideoextras>false</hasvideoextras>
			<isdefaultvideoversion>true</isdefaultvideoversion>
			</syntaxhighlight>

			The process to import these tags during scanning is not complete. As a result, you will still be asked if you would like to add movies as a version of an existing during scanning.

			Once the nfo file module is complete, rebuilding from nfo files will automatically allocate movies to versions.

Karellen: Updates

2024-01-12T00:32:13Z

Updates

Show changes

Karellen at 23:08, 10 January 2024

2024-01-10T23:08:24Z

Show changes

Karellen: First creation

2024-01-09T00:46:35Z

First creation

New page

{{mininav|[[Video library]]|[[Video management|Management]] }}

= 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.

Do you have the DVD, Bluray, 3D and 4K version of a movie?
Do you have the Theatrical Release, Director's Cut, Extended version or any other type of version of a movie?
Do you dislike the same movie 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 movie is selected as the parent movie, which is the default movie, and other versions are added to this parent movie.

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.
<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) - Intl Theatrical Cut [dvd] (child version)
|- Blade Runner (1982) - The Final Cut [bluray] (child version)
|- 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.

Versions are matched as follows:
# The scanner first checks for duplicate TMDB or IMDB UniqueID
# If no ID is matched, then the scanner checks for a duplicate Title.
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
# 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>

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

{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Basic
|- valign="top"
| '''Description:'''
|
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.
* '''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.
|}

{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Standard
|- valign="top"
| '''Description:'''
|
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
* '''Enabled''' - Plays the default parent video. Other versions can be accessed from ''Context menu ► Choose version''
|}

{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Standard
|- valign="top"
| '''Description:'''
|
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''
* '''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. 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.

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

To create a Video Version, follow these steps.

# Highlight the movie that will become the parent/default and call up the Context Menu
# 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
# 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
# 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
# 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'''

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''
# 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
# 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
# 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
# The Update Library scanner will continue with the scan until it finds another duplicate movie.

= Managing Versions =

{{top}}

{{updated|21}}

[[Category:Karellen]]
[[Category:Video library]]