Video library tags: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
m (Updated for v19)
(21 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{mininav||[[General topics]]|[[Videos]]|[[Video library/Navigation|Navigation]] {{l2| [[Video library/Management|Management]] }} }}
{{mininav|[[Video library]]|[[Video management|Management]] }}
<section begin="intro" />Since v12 Frodo, XBMC supports [http://en.wikipedia.org/wiki/Tag_(metadata) Tags] which can be applied to movies, TV shows, and music videos. They are meant to supplement [[Movie sets]] which are (by design) limited in their usage. A movie or TV show can have multiple tags attached and a tag can contain multiple tags. They can be used as keywords, categories, filters, or whatever you want. Movies and TV shows can have multiple tags. Tags can be used to filter and navigate the library. Tags can be edited and managed directly from the XBMC GUI.<section end="intro" />


== Managing tags ==
=== in XBMC ===
There is limited support to manage tags in XBMC. {{highlight|bordered=yes|Videos -> Library -> Movies -> Tags}} will display a list of all the existing tags. Opening a tag will show the list of movies or TV shows which have that specific tag attached.
==== Creating a new tag ====
Using the "New tag..." button will open an input dialog where the user can enter the name of the new tag. If there's already a tag with that specific name an error will pop up and the process will be aborted. Otherwise the new tag will be created and the user will be prompted with a list of all movies. The user can select one or multiple movies which should be added to the new tag. Pressing OK will close the dialog and bring the user back to the list of tags where the newly created tag should be listed as well.


[[File:Tags1.png]]
= Introduction =
<section begin="intro" />Video library tags, ''aka Tags or Keywords'', can be used to further sort and organise your library into meaningful lists. Sites such as IMDB and TheMovieDB use Keywords to describe themes, plot details or character types to group and easily locate similar titles. They are generally different to the genre.<section end="intro" />


[[File:Tags2.png]]
You may create tags for whatever purpose you require, such as ''Mums movies'', ''Vampires'', ''Easter movies'' etc. They can also be used as a Rule criteria in [[Smart playlists]].
 
Tags are a video library feature and require a correctly scanned or scraped library. They can be used in Movies, TV Shows and Music Videos. Tags are not available in file view mode.
 
Movies and TV Shows cannot be combined into the same tag.
 
Using a compatible skin, these tag lists can be added as a main menu or sub-menu item. '''See: [[Custom home items]]'''
 
This wiki page uses Movies as the example, but it applies equally to TV Shows and Music Videos
 
 
 
= Create Tags =
There are 3 methods to create a tag:
 
 
== GUI ==
This is the most common method to create a tag. Select '''Videos''' from the main menu, then Follow the images to create a tag.
 
<gallery mode="packed" widths="500px" heights="283px">
File:VideosMenu01.jpg|Image 1: From the Video menu select either Movies, TV Shows or Music Videos
File:tags1.jpg|Image 2: Select Tags from the bottom of the list
File:tags2.jpg|Image 3: A list of existing tags is displayed and accessed from this page.<br> Select '''New tag...'''
File:tags3.jpg|Image 4: Type in the name of your new tag and select '''OK'''
File:tags4.jpg|Image 5: From the pop-up Select Movies box, choose each movie to add to the list.<br> Use {{keypress|Enter}} on a keyboard to select, then move to the next item.<br>Press '''OK''' when finished.
</gallery>
'''Note:''' At least one title must be added to the tag for the tag to be created.
 
 
== NFO Files ==
Tags can be added to NFO files by using the following XML tag in your NFO file:
 
<syntaxhighlight lang="xml">
<tag></tag>
</syntaxhighlight>
 
Multiple tags can be used. If a tag value already exists in your library, then the item will be added to the existing tag list. If the tag does not exist, then a new tag will be created in your library.
 
'''''See: [[NFO files]]'''''
 
 
== Scrapers ==
The following two movie scrapers can download keywords from TheMovieDB:
*Universal Movie Scrapers... [[Add-on:Universal Movie Scraper]]
*The Movie Database Python... [[Add-on:The Movie Database Python]]
 
This feature needs to be enabled in the scraper settings. Both scrapers can be installed via the Kodi repository.
 
Be aware that some movies can have twenty or more tags and all these will be scraped into the library.
 
There is currently no scraper that can download tags for TV shows or Music Videos.
 
 
 
= Accessing Tags =
Tags are accessed from the Videos menu as follows:
:Movies - {{highlight|bordered=yes|Videos > Movies > Tags}}
:TV Shows - {{highlight|bordered=yes|Videos > TV Shows > Tags}}
:Music Videos - {{highlight|bordered=yes|Videos > Music Videos > Tags}}
 
See Image 3 in section 2.1 above.
 
 
 
= Managing tags =
Tags can be modified to add or remove titles or to delete the tag completely.
 
<gallery mode="packed" widths="500px" heights="283px">
File:tags2.jpg|Image 6: Highlight the tag to be modified
File:tags5.jpg|Image 7: Call up the '''[[Basic_controls#Context_Menu|Context Menu]]''' and select '''Manage'''
File:tags6.jpg|Image 8: Select the option you require.<br> See below for further details
</gallery>


==== Modifying existing tags ====
Opening the context menu of a specific tag will provide several options to modify the tag and the items it contains:
[[File:Tags context menu.jpg|left]]
; Add Movies
; Add Movies
: Opens a dialog with the list of all movies that do not have this tag attached yet. The user can select one or multiple movies which should be added to this tag.
: Opens a dialog with the list of all titles that do not have this tag attached yet. The user can select one or multiple titles to add to this tag.


; Remove Movies
; Remove Movies
: Opens a dialog with the list of movies that have this tag attached. The user can select one or multiple movies which should be removed from this tag. Removing all movies will not remove the tag.
: Opens a dialog with the list of titles that have this tag attached. The user can select one or multiple titles to be removed from this tag. Removing all titles will not remove the tag.


; Remove from library
; Remove from library
: Attempts to remove the tag from the library. The user will be prompted to confirm whether the tag should really be removed. Removing a tag will not remove the items it contains. It will only remove the specific tag from the library and therefore also from all the movies that had this tag attached.
{{warning|The '''Remove from library''' option is broken from v17 and later. Use the '''Remove Movies''' option and remove all movies from the tag instead.<ref>https://github.com/xbmc/xbmc/issues/18470</ref>  Fixed for v19<ref>https://github.com/xbmc/xbmc/pull/18549</ref>|20px}}
{{-}}
: Removes the tag from all titles that contain it, then deletes the tag. The user will be prompted to confirm whether the tag should really be removed. It does not delete any titles from the library, only the tag attached to the title.
 
 
 
= Add-ons =
The following tag related add-ons are available from the {{kodi}} repository or are available on the forum as a zip install.
 
;[[Add-on:ManageTags]]
:Adds a context menu entry for movies and tvShows (under manage) to allow the selection of tags
 
;[[Add-on:Tag_Generator]]
:Helps you create Smart Playlists from IMDb/Trakt Watchlists by tagging local movies found in specified lists. Also creates a stand-up comedy tag based on Wikipedia comedians, as there is no genre for stand-up. Specify your IMDb/Trakt watchlists then choose your desired Kodi tag for each list. Runs as a service in the background at a specified interval, and also allows for manual creation. For Trakt, you can add lists from your own account, from public accounts, or shared lists from anyone you are friends with (people you follow, who follow you back). Oscar tagging lets you tag winners and/or nominees with each award for each movie in the following format 'Winner: Best Motion Picture'.
 
;[https://github.com/fnord12/script.tagoverview TagOverview]
:Add tags to movies and tv shows from either the context menu or by mapping a remote control button to run the script.  


=== through NFO files ===
To add a movie to one or multiple tags an  [[NFO file]] can be created and for every tag an XML tag can be added like this
If there's no tag with the specified name it will be automatically created and the tag will be attached to the movie.
{{tip|See '''[[NFO files/movies#Movie tags|NFO files]]'''}}


== Usage ==
Apart from the Tags view in {{highlight|bordered=yes|Videos -> Library -> Movies -> Tags}}, tags can currently only be used in [[Smart Playlist]]s as rules. In the future tags will be extended to work with other areas of XBMC. For example, they could be integrated into the video info dialog and other parts of the user interface.


{{Gotham note|Tags for TV shows and music videos are only available as smart playlist rules in [[development builds]] for v13. v12 "Frodo" only supports Movie tags for smart playlists.}}
= References =
<References />


== See also ==
* [[Movie sets]]


=== Similar page names ===
{{top}}
{{#lst:Tags|similar pages}}
{{updated|19}}


[[Category:XBMC Manual]]
[[Category:Karellen]]
[[Category:Video Library]]
[[Category:Video library]]
{{Frodo updated}}

Revision as of 21:05, 15 April 2021

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


Introduction

Video library tags, aka Tags or Keywords, can be used to further sort and organise your library into meaningful lists. Sites such as IMDB and TheMovieDB use Keywords to describe themes, plot details or character types to group and easily locate similar titles. They are generally different to the genre.

You may create tags for whatever purpose you require, such as Mums movies, Vampires, Easter movies etc. They can also be used as a Rule criteria in Smart playlists.

Tags are a video library feature and require a correctly scanned or scraped library. They can be used in Movies, TV Shows and Music Videos. Tags are not available in file view mode.

Movies and TV Shows cannot be combined into the same tag.

Using a compatible skin, these tag lists can be added as a main menu or sub-menu item. See: Custom home items

This wiki page uses Movies as the example, but it applies equally to TV Shows and Music Videos


Create Tags

There are 3 methods to create a tag:


GUI

This is the most common method to create a tag. Select Videos from the main menu, then Follow the images to create a tag.

Note: At least one title must be added to the tag for the tag to be created.


NFO Files

Tags can be added to NFO files by using the following XML tag in your NFO file:

<tag></tag>

Multiple tags can be used. If a tag value already exists in your library, then the item will be added to the existing tag list. If the tag does not exist, then a new tag will be created in your library.

See: NFO files


Scrapers

The following two movie scrapers can download keywords from TheMovieDB:

This feature needs to be enabled in the scraper settings. Both scrapers can be installed via the Kodi repository.

Be aware that some movies can have twenty or more tags and all these will be scraped into the library.

There is currently no scraper that can download tags for TV shows or Music Videos.


Accessing Tags

Tags are accessed from the Videos menu as follows:

Movies - Videos > Movies > Tags
TV Shows - Videos > TV Shows > Tags
Music Videos - Videos > Music Videos > Tags

See Image 3 in section 2.1 above.


Managing tags

Tags can be modified to add or remove titles or to delete the tag completely.

Add Movies
Opens a dialog with the list of all titles that do not have this tag attached yet. The user can select one or multiple titles to add to this tag.
Remove Movies
Opens a dialog with the list of titles that have this tag attached. The user can select one or multiple titles to be removed from this tag. Removing all titles will not remove the tag.
Remove from library
Stop hand.png The Remove from library option is broken from v17 and later. Use the Remove Movies option and remove all movies from the tag instead.[1] Fixed for v19[2]
Removes the tag from all titles that contain it, then deletes the tag. The user will be prompted to confirm whether the tag should really be removed. It does not delete any titles from the library, only the tag attached to the title.


Add-ons

The following tag related add-ons are available from the Kodi repository or are available on the forum as a zip install.

Add-on:ManageTags
Adds a context menu entry for movies and tvShows (under manage) to allow the selection of tags
Add-on:Tag_Generator
Helps you create Smart Playlists from IMDb/Trakt Watchlists by tagging local movies found in specified lists. Also creates a stand-up comedy tag based on Wikipedia comedians, as there is no genre for stand-up. Specify your IMDb/Trakt watchlists then choose your desired Kodi tag for each list. Runs as a service in the background at a specified interval, and also allows for manual creation. For Trakt, you can add lists from your own account, from public accounts, or shared lists from anyone you are friends with (people you follow, who follow you back). Oscar tagging lets you tag winners and/or nominees with each award for each movie in the following format 'Winner: Best Motion Picture'.
TagOverview
Add tags to movies and tv shows from either the context menu or by mapping a remote control button to run the script.


References


Return to top