[sualfred]

Metadata Editor Script
Kodi script to edit basic metadata information of library items with support to automatically update the .nfo file.

Supported Kodi versions

• Leia
  
• Matrix (Untested yet, but should work out of the box.)
  

Where to get it

• The most current versions are always available on my private Kodi repo
  
• Once everything is 100% working it gets released on the Kodi repo
  

Supported .nfo types
The updating of .nfo items is only possible for video library items, because the JSON result doesn't return any path for music entries.

Supported .nfo namings:

• %Filename%.nfo
  
• tvshow.nfo
  
• movie.nfo
  

By default the script is creating a .nfo if missing. This can be disabled in the settings.

Scrapers
The script is using TMDb (free) and OMDb.

I already have included a TMDb API key (hardcoded).

For OMDb please visit https://omdbapi.com/ and create your own API key and add it to the addon settings.
Please note that the free available OMDb API key is limited to 1.000 calls a day. I highly recommend to become a patreon of the creator of OMDb.
For $1 a month your daily limit gets increased to 100.000 calls / day. Support it and benefit.

TMDb scraper (not used for episodes, because of different global airing dates and episode orders):

• Rating + votes
  
• MPAA
  
• Premiered year
  
• TV show status
  
• External unique IDs (IMDb, TVDb)
  

OMDb scraper:

• Rotten ratings (all four of them incl. votes)
  
• Metacritic (just rating, no votes available)
  
• IMDb (ID + rating + votes)
  

Note:
There is a experimental setting available to use title + year for the OMDb call, if the IMDb ID is not available. It's disabled by default, because there is a high chance for false positive returnings and wrong fetched metadata. I do not recommend to enable it.

Running service

• Updates the watched states in the .nfo automatically if item is played or marked/unmarked as watched (can be disabled)
  
• Option to rate your movie/episode after it has been played 100% (can be disabled)
  

Additional features of the rating updater

• Updates MPAA (can be disabled)
  
• Updates TV show status
  
• Updates missing uniqueids
  
• Updates original title
  

You can configure the preferred MPAA rating in the addon settings.
It's also possible to skip "not rated" or to enable/disable the fallback to US ratings


Run the script / context menu
The script can be called with the context menu or RunScript() commands (useful for skinners).
A library updating task can be started by starting the addon itself.

Context menu entries:
 

• Metadata Editor / Open Editor = editor dialog or sub menu if more options are available
  
• Add/remove available genres = quickly edit the genres which the item belongs to
  
• Add/remove available tags = quickly edit the tags which the item belongs to
  
• Add/remove favourite tag = shortcut to toggle the library tag Watchlist. Can be used to create custom splitted favourite widgets.
  
• Update .nfo = updates the .nfo
  
• Update ratings = will update ratings by using the OMDb and TMDb API
  

RunScript calls:

• RunScript(script.metadata.editor,dbid=$INFO[ListItem.DBID],type=$INFO[ListItem.DBType]) = opens editor
  
• RunScript(script.metadata.editor,action=setuserrating,dbid=$INFO[ListItem.DBID],type=$INFO[ListItem.DBType]) = sets user rating and updates the nfo if enabled
  
• RunScript(script.metadata.editor,action=setgenres,dbid=$INFO[ListItem.DBID],type=$INFO[ListItem.DBType]) = opens genre selector
  
• RunScript(script.metadata.editor,action=settags,dbid=$INFO[ListItem.DBID],type=$INFO[ListItem.DBType]) = opens tags selector
  
• RunScript(script.metadata.editor,action=togglewatchlist,dbid=$INFO[ListItem.DBID],type=$INFO[ListItem.DBType]) = toggle watchlist tag
  
• RunScript(script.metadata.editor,action=updatenfo,dbid=$INFO[ListItem.DBID],type=$INFO[ListItem.DBType]) = updates the .nfo
  

RunScript calls for updating ratings:

• RunScript(script.metadata.editor) = Shows select dialog to update movies, shows and episodes or all of them
  
• RunScript(script.metadata.editor,action=updaterating,dbid=$INFO[ListItem.DBID],type=$INFO[ListItem.DBType]) = Updates rating for the requested item
  
• RunScript(script.metadata.editor,action=updaterating,content=movies) = Updates all ratings for movies (combination of available TMDb, TVDb, IMDb IDs)
  
• RunScript(script.metadata.editor,action=updaterating,content=tvshows) = Updates all ratings for TV shows (combination of available TMDb, TVDb, IMDb IDs)
  
• RunScript(script.metadata.editor,action=updaterating,content=episodes) = Updates all ratings for TV shows (only if IMDb is available)
  
• RunScript(script.metadata.editor,action=updaterating,content=movies+tvshows+episodes) = Updates all ratings for provided content. Values are splitted by '+'
  

Help to translate the script into your language!
Translate on TransiFex


Donations
Free beer or money for the tip jar of my daughter is welcome and helps me to stay motivated
Please click here to donate


Screenshot

---

Moderator Edit
The original author @sualfred has not been active for a couple of years.
A forked version for v20 by @HeresJohnny can be found here... https://forum.kodi.tv/showthread.php?tid...pid3109732

---