From Official Kodi Wiki
< User:Karellen
Revision as of 23:47, 16 January 2018 by Karellen (talk | contribs)
Jump to navigation Jump to search
Create Video Libraries
1. The Basics
2. Source Folder
3. Movie Setup
4a. TV Show Setup
4b. Seasons Setup
4c. Episodes Setup
5. Music Videos Setup
6. Add Source & Scrape
7. Scraping Problems
Home icon grey.png   ▶ Video library ▶ Management ▶ Naming video files ▶ scratchpad

1 Introduction

Kodi v18 introduces limited support for reading of embedded tags and images in *.mkv and *.mp4 video files. A very sought after feature for many members.

mp4 tags are standardized, but only for a rather small subset of the the information kodi can use, see above.. (spiff)

TV Shows are not yet supported.

1.1 Why do I want this?

There are multiple reasons why one would want to use this feature: Media may already contain useful metadata (the reverse however is also true - many files contain "junk" metadata, hence why the feature defaults to off). It gives one more control over the metadata than scrapers do (as scrapers may misclassify media and pull the wrong data). It does away with the need to have .nfo files. Since metadata travels with the media file, there is no longer a need for potentially thousands of these smaller files and can make directory management even easier. Using ultra-high resolution Artwork/cover images that looks nicer on newer HD displays.(Pretty pictures!)

1.2 How does it change/differ to the old model?

Kodi has two options for metadata import: using an online scraper or using local information, traditionally in the form of .nfo files. local tag reading is bundled into the "Local Information" arm, as logically, metadata is still local (i.e not network-drawn) information. Thus, one can still use a combination of .nfo files and embedded information if they choose "Local Information" rather than to use a scraper.

It is important to note however that .nfo files will override embedded information. (

In essence this is meant to supplement, not replace, the traditional .nfo metadata.

1.3 Settings

The Kodi settings has the option to enable or disable the reading of video file tags. The default setting is disabled.
link to settings page here- Settings>Media Settings>Videos>Use video tags

This page assumes this setting has been enabled.

2 Folder & File Structure

The use of Video File Tags does not absolve you from using the correct Folder and File structure for Movies, TV Shows and Music Videos as detailed in the previous pages. Use the navbox above to locate and read those requirements.

3 Tagging

There's currently no proper video tagging software that's user-friendly. (martijn)


3.1 Windows

mp3tag is a Windows based metadata editor for many different files types, including MP4 (despite what it's name may suggest). While somewhat complex, it provides very fine-grained control over tagging, and is a worthwhile asset in any media management library.

MetaX is a user friendly tagging solution, However it is proprietary and paid ($10). It features much the same core features as MP3tag, but adds an online search functionality to grab metadata from providers such as iTunes, Amazon and others, as well as an autotag feature. This can be useful to people with enormous media collections where the time saved manually tagging justifies the price.

3.2 Mac

MetaX was once available for free on macOS, It however seems to be abandoned and replaced by another project... MetaZ.

3.3 Linux

4 A note on iTunes

Apple, in their wisdom, have created a subset of tags that are strictly speaking only meant for use with iTunes. However, most tagging software can read and write these iTunes tags.

5 Supported Tags

are the tags in this table for both mkv and mp4?

Is it ok to remove the music related tags? Are they separated accurately?

I cannot find these video related tags in mp3tag

What format is this- id3, APE, Generic, MP4, other?

IMDBURL/TMDBURL is this one tag or two separate tags?

Video File Tags
? Tag Type Description
-B -podcast NUM Set the podcast flag
-c -comment STR Set a general comment
-C -copyright STR Set the copyright information
-e -encodedby STR Set the name of the person or company who encoded the file
-E -tool STR Set the software used for encoding
-g -genre STR Set the genre name
-G -grouping STR Set the grouping name
-H -hdvideo NUM Set the HD flag (1\0)
-i -type STR Set the Media Type(tvshow, movie, music, ...)
-I -contentid NUM Set the content ID
-j -genreid NUM Set the genre ID
-l -longdesc STR Set the long description
-m -description STR Set the short description
-M -episode NUM Set the episode number
-n -season NUM Set the season number
-N -network STR Set the TV network
-o -episodeid STR Set the TV episode ID
-O -category STR Set the category
-p -playlistid NUM Set the playlist ID
-P -picture PTH Set the picture as a .png
-r -remove STR Remove tags by code (e.g. "-r cs" removes the comment and song tags)
-S -show STR Set the TV show
-X -rating STR Set the Rating(none, clean, explicit)
-y -year NUM Set the release date
-help Display this help text and exit
-version Display version information and exit
Music File Tags- TO BE REMOVED FROM LIST? or is it used for Music Videos?
? Tag Type Description
-A -album STR Set the album title
-a -artist STR Set the artist information
-b -tempo NUM Set the tempo (beats per minute)
-d -disk NUM Set the disk number
-D -disks NUM Set the number of disks
-L -lyrics NUM Set the lyrics
-R -albumartist STR Set the album artist
-s -song STR Set the song title
-t -track NUM Set the track number
-T -tracks NUM Set the number of tracks
-w -writer STR Set the composer information
-z -artistid NUM Set the artist ID
-Z -composerid NUM Set the composer ID
  • for mkv you can add an attachment named kodi-metadata. this is an an embedded .nfo file
  • for mkv you can add an attachment named kodi-override-metadata. if combined with specifying IMDB/TMDB url, you get a url nfo. if alone, you get an override nfo

6 Artwork

for mkv you can have embedded thumbs. currently limited to:
   - 'small_cover.png' or 'small_jover.jpg' for thumbnails (as specified on
   - 'cover.png' or 'cover.jpg' for posters (as specified on
   - 'fanart.png' or 'fanart.jpg' for fanart

MP4 artwork is supported.

Return to top

Next step: Naming Movies