User:Karellen/scratchpad: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
m (Reverted edits by Karellen (talk) to last revision by DeShizz)
Line 1: Line 1:
{{mininav|[[Video library]]|[[Video_management|Video Management]]|[[Custom_home_items|Custom Home Items]]}}
{{VideoLibraryCreate}}
[[File:CustomMenuItem25.jpg|500px|right]][[File:CustomMenuItem26.jpg|500px|right]]
{{mininav|[[Video library]]|[[Video management|Management]]|[[Naming video files]]}}
 


= Introduction =
= Introduction =
<section begin="intro" />In a default Kodi installation, with a properly setup and scraped library, all Movies will be under the Main Menu '''Movie''' button, and your TV shows will be under the '''TV Shows''' button. All your Sci Fi movies will be mixed in with your Westerns, Animated, Romantic Comedies, Concert Films, etc. and the same for your different TV show types or genres.
<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.


This Guide explains the process of creating new Main Menu items to enable separate main menu listings. Example uses include:
== Why do I want this? ==
*Separating childrens movies from mature movies
There are multiple reasons why one would want to use this feature:
*Separately list documentaries, cartoons, sci-fi or any other genre
Media may already contain useful metadata (the reverse however is also true - many files contain "junk" metadata, hence why the feature defaults to off).
*Separately list Home Movies <section end="intro" />
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!)


With Smart Playlists and a skin like Aeon Nox 5 (and its variants), as well as most other skins, you can have specific Main Menu buttons for each library that will show only those videos you have chosen for each Main Menu button as shown in the example images.
== 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.


Note: This guide assumes you know how to install Kodi, install skins, and add Sources to your Kodi library, and have installed the Aeon Nox 5: SiLVO skin
It is important to note however that .nfo files will override embedded information. (https://forum.kodi.tv/showthread.php?tid=326340)


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


'''{{red|This function is skin dependant and does not work on the default Estuary skin. For the purpose of this guide, we are using Kodi v17.6 with the Aeon Nox 5: SiLVO skin. If you are using a different skin the process is the same, but you will need to find the appropriate screens in your skin.}}'''


'''{{red|For the purpose of this guide, the Smart Playlist is created using the ''Paths'' rule type as shown in the next section, ''Folder Structure''. The Smart Playlist can be based on any of the listed rule types.}}'''
== 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}}


This page assumes this setting has been enabled.




= Folder Structure =
The correct folder structure will ensure a relatively hassle free experience in setting up these menu buttons.


Organize the video files on your file server/NAS/local hard drive into separate folders for each Main Menu button you require.


The image below is an example of how you might organize your folders and files (Windows 10). Each category that you intend to have as a movie menu item, will have the movies saved in a specific folder.
= 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.


[[file:CustomMenuItemFolder.png|300px|left]]
{{-}}




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


= Create Smart Playlists =
THE FOLLOWING SOFTWARE IS NOT ENDORSED BY TEAM KODI.
The first step is to create a '''''[[Smart_playlists|Smart Playlist]]''''' for each new listing you require. The following is a simple guide to accomplish that:


#Click '''SYSTEM''' on the Main Menu, then in the window that opens click on the '''System''' icon. In the bottom left corner by the '''gear''' symbol ensure '''EXPERT''' is chosen.
== Windows ==
#Add each folder as a '''Source''' to the Kodi library using the '''Add Video Source''' dialog box, being sure to select the content type (Movies or TV, etc.) correctly.
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.


<gallery widths=450px heights=250px>
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.
File:CustomMenuItem01.jpg|3. After each folder has been added as a Source and scraped, go to the '''Playlists''' button under the '''Videos''' Main Menu button.
File:CustomMenuItem02.png|4. Choose '''New smart playlist…'''
File:CustomMenuItem03.png|5. In the '''Type''' menu choose '''Movies''' or '''TV''' as appropriate.
File:CustomMenuItem04.png|6. In the '''EDIT SMART PLAYLIST''' dialog box click on '''New rule…'''.
File:CustomMenuItem05.png|7. In the '''CHOOSE RULE TYPE''' dialog box click on the word '''Title''' and choose '''Path''' from the '''CHOOSE RULE TYPE''' menu.
File:CustomMenuItem06.png|8. Now, click on the word '''contains'''.
File:CustomMenuItem07.png|9. Choose '''starts with''' from the '''SMART PLAYLIST RULE''' dialog box.
File:CustomMenuItem08.png|10. Click on the word '''Browse''' in the '''SMART PLAYLIST RULE''' dialog box.
File:CustomMenuItem09.png|11. Choose the library you want, then click OK.
File:CustomMenuItem10.png|12. The contents of the library will be listed, click '''OK''' again.
File:CustomMenuItem11.png|13. Click '''OK''' again.
File:CustomMenuItem12.png|14. Click '''OK''' once more.
File:CustomMenuItem13.png|15. An onscreen keyboard will appear, type the name of your new Smart Playlist, click '''DONE'''.
</gallery>


:16. Repeat the above steps as needed to build all the Smart Playlists you want, then back out to the home screen.
== Mac ==


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


== Linux ==


= Customising The Main Menu =
This step will create the new Main Menu items. The next section is a straight continuation of the steps in this section.


<gallery widths=450px heights=250px>
File:CustomMenuItem14.jpg|17. Click on '''SKIN SETTINGS''' under '''SYSTEM''' in the Main Menu.
File:CustomMenuItem15.png|18. In the next screen, click on '''Setup the Aeon Nox main menu''' (note: this guide is specific to Aeon Nox 5: Silvo v6.0.12 on Kodi v17 Krypton, your installation may be different).
File:CustomMenuItem16.png|19. The '''MAIN MENU CUSTOMIZER''' windows opens and will look like the above image
</gallery>


The Menu Items are on the left. The X deletes the item, the + adds a new one '''below''' the existing item, the arrows move the items up/down in the list and changes their position in the Main Menu accordingly. (note: The Default center Main Menu item is the third '''active''' menu item. In this example, it is '''WEATHER'''). On the right are the Menu Menu button modifiers.
= A note on iTunes =


Continue on with the next section
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.


= Supported Tags =


= Adding The Smart Playlists To The Main Menu =
{{red|are the tags in this table for both mkv and mp4?}}
This final step now links the Smart Playlists created in Section 3 to the new Main Menu items created in the previous Section.


<gallery widths=450px heights=250px>
{{red|Is it ok to remove the music related tags? Are they separated accurately?}}
File:CustomMenuItem17.png|20. Select a Main Menu item you want to change, or click the plus sign to create a new one. If you create a new item, it will appear below the selected menu item with the label '''NONE'''. Either way, on the right side, select '''Choose item for menu''' and a pop out menu will appear.
File:CustomMenuItem18.png|21. Click on '''Video Library'''.
File:CustomMenuItem19.png|22. In the pop out menu that appears next, choose '''Playlist'''
File:CustomMenuItem21.png|23. In the Playlist pop out menu, choose the required Playlist
File:CustomMenuItem22.png|24. In the '''What do you want to do with the playlist?''' box, choose '''Display'''
File:CustomMenuItem23.png|25. If you want, you can select background fanart for the individual playlists. This will rotate through fanart that is specific to that playlist.
File:CustomMenuItem24.png|26. Now scroll thru the pop out menu to '''(Video Playlist) <your playlist>'''
</gallery>


:27a. Repeat these steps as needed to add your playlists to the Main Menu, adjust their positions on the Menu to your liking, add widgets, etc.
{{red|I cannot find these video related tags in mp3tag}}


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


:27b. If you have no further buttons to add, simply '''back''' out to return to the Home Screen. At this point a script will run to re-build the Main Menu.
{{red|IMDBURL/TMDBURL is this one tag or two separate tags?}}






= Duplicated Listings =
If you prefer to not have the same Movie or TV Show listed in the original Movie and TV Show buttons along with being listed in the newly created buttons, then follow these steps:
#Disable the original Movie or TV Show button in the '''Main Menu Customizer''' screen as shown in step 19
#Repeat the steps detailed on this page to create a new button with a suitable name and a new Smart Playlist that '''excludes''' the videos that are included in the new buttons.


{| 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


'''{{big|You’re done!}}'''
 
 
= 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
 
MP4 artwork is supported.






<gallery widths=500px heights=280px>
File:CustomMenuItem25.jpg
File:CustomMenuItem26.jpg
</gallery>




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


{{updated|17}}
{{updated|17}}

Revision as of 03:10, 31 January 2018

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


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.

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!)

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. (https://forum.kodi.tv/showthread.php?tid=326340)

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


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.



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.


Tagging

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

THE FOLLOWING SOFTWARE IS NOT ENDORSED BY TEAM KODI.

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.

Mac

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

Linux

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.

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


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

MP4 artwork is supported.



Return to top


Next step: Naming Movies
Retrieved from "https://kodi.wiki/index.php?title=User:Karellen/scratchpad&oldid=132682"