{{VideoLibraryCreate}}
{{mininav|[[Video library]]|[[Video management|Management]]|[[Naming video files]]}}

= Introduction =
<section begin="intro" />{{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.<section end="intro" />

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.

== 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.
Pretty pictures!

= Settings =
The {{kodi}} settings has the option to enable or disable the reading of video file tags. The default setting is disabled.<br />
{{red|link to settings page here- Settings>Media Settings>Videos>Use video tags}}

= 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|Music Videos]] as detailed in the previous pages. Use the navbox above to locate and read those requirements.

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

== Windows ==
mp3tag is a Windows based metadata editor for many different files types, including MP4 (despite what it's name may suggest).

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.

== Mac ==

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

== Linux ==

= Supported Tags =

{{red|are the tags in this table for both mkv and mp4?}}

{{red|Is it ok to remove the music related tags? Are they separated accurately?}}

{{red|I cannot find these video related tags in mp3tag}}

{{red|What format is this- id3, APE, Generic, MP4, other?}}

{{red|IMDBURL/TMDBURL is this one tag or two separate tags?}}

{| class="prettytable"
|-
! colspan="4" style="background-color:#a1f5e4;" | Video File Tags
|+
! style="background-color:#f5f5a1; text-align:left; width:050px" | ?
! style="background-color:#f5f5a1; text-align:left; width:100px" | Tag
! style="background-color:#f5f5a1; text-align:left; width:050px" | Type
! style="background-color:#f5f5a1; text-align:left; width:450px" | 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
|-
! colspan="4" style="background-color:#a1f5e4;" | Music File Tags- TO BE REMOVED FROM LIST? or is it used for Music Videos?
|+
! style="background-color:#f5f5a1; text-align:left; width:050px" | ?
! style="background-color:#f5f5a1; text-align:left; width:100px" | Tag
! style="background-color:#f5f5a1; text-align:left; width:050px" | Type
! style="background-color:#f5f5a1; text-align:left; width:400px" | 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

= Artwork =

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

{{top}}

<div style="{{linear-gradient|left|#a1f5e4, #f5f5a1}}">{{next|[[Naming_video_files/Movies|'''Naming Movies''']]}} </div>

{{updated|17}}
[[Category:FAQ]]
[[Category:Index]]
[[Category:How-to]]
[[Category:Guides]]
[[Category:Manual]]
[[Category:Video library]]
[[Category:General topics]]
[[Category:First time user]]
[[Category:Quick Start Guide]]

User:Karellen/scratchpad

2018-01-16T10:54:06Z

DeShizz:

{{VideoLibraryCreate}}
{{mininav|[[Video library]]|[[Video management|Management]]|[[Naming video files]]}}

= Introduction =
<section begin="intro" />{{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.<section end="intro" />

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.

= Settings =
The {{kodi}} settings has the option to enable or disable the reading of video file tags. The default setting is disabled.<br />
{{red|link to settings page here- Settings>Media Settings>Videos>Use video tags}}

= 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|Music Videos]] as detailed in the previous pages. Use the navbox above to locate and read those requirements.

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

<section begin="Windows" />
mp3tag.

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.

<section end="Windows" />

other software

= Supported Tags =

{{red|are the tags in this table for both mkv and mp4?}}

{{red|Is it ok to remove the music related tags? Are they separated accurately?}}

{{red|I cannot find these video related tags in mp3tag}}

{{red|What format is this- id3, APE, Generic, MP4, other?}}

{{red|IMDBURL/TMDBURL is this one tag or two separate tags?}}

{| class="prettytable"
|-
! colspan="4" style="background-color:#a1f5e4;" | Video File Tags
|+
! style="background-color:#f5f5a1; text-align:left; width:050px" | ?
! style="background-color:#f5f5a1; text-align:left; width:100px" | Tag
! style="background-color:#f5f5a1; text-align:left; width:050px" | Type
! style="background-color:#f5f5a1; text-align:left; width:450px" | 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
|-
! colspan="4" style="background-color:#a1f5e4;" | Music File Tags- TO BE REMOVED FROM LIST? or is it used for Music Videos?
|+
! style="background-color:#f5f5a1; text-align:left; width:050px" | ?
! style="background-color:#f5f5a1; text-align:left; width:100px" | Tag
! style="background-color:#f5f5a1; text-align:left; width:050px" | Type
! style="background-color:#f5f5a1; text-align:left; width:400px" | 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

= Artwork =

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

{{top}}

<div style="{{linear-gradient|left|#a1f5e4, #f5f5a1}}">{{next|[[Naming_video_files/Movies|'''Naming Movies''']]}} </div>

{{updated|17}}
[[Category:FAQ]]
[[Category:Index]]
[[Category:How-to]]
[[Category:Guides]]
[[Category:Manual]]
[[Category:Video library]]
[[Category:General topics]]
[[Category:First time user]]
[[Category:Quick Start Guide]]