An add-on for Kodi to manage artwork
Switch branches/tags
Nothing to show
Clone or download

README.md

Artwork Beef

An add-on for Kodi

Artwork Beef automatically adds extra artwork for media in your video and music libraries. It is generally intended to handle extended artwork just as Kodi and scrapers already do for basic artwork. It grabs artwork from the wonderful web services fanart.tv, TheTVDB.com, The Movie Database, and TheAudioDB.com.

It is developed for Kodi 17 Krypton, and should also work for 16 Jarvis and 18 Leia. 15 Isengard should mostly still work, but it's really time to update.
Support and feedback thread on the Kodi forums.
Source hosted on GitHub.

Full documentation available at https://rmrector.github.io/script.artwork.beef/.

Current gotchas

  • Music library support is for Kodi 18 Leia only, and requires a recent nightly from 2018
  • It doesn't add animated artwork, yet
  • It cannot set artwork for "all seasons". related trac ticket

Thoughts

  • Scrapers and NFO files need to set web service IDs like IMDB number, TVDB ID, or TMDB ID for media types that Kodi supports such IDs for: movies, TV shows, and episodes
    • Music files need to be tagged with MusicBrainz IDs; Artist, Release Group, and Track IDs
  • Movie thumbnails aren't added from external sources. There is no way to tell the difference between stills and press/marketing images from the web services, while thumbs should only include stills. Skins can try multiple fanart for a similar look. Generating more than one thumb from a video file is outside the scope of this add-on, but any provided by a media manager is added to the library. Plugins can also set these to the ListItem, if their source provides more than one thumbnail.
  • It would be nice to have a Kodi built-in way for skins to feed multiple art to a multiimage, maybe something like $INFO[ListItem.MultiArt(fanart)] to pull all fanart and fanart# together. I have no idea how it could be implemented in Kodi, though.

Running from source

The API keys have been removed from the repo, and are only included in the final installable zip. Individual users that need to run from source can copy projectkeys.py from the installable zip to the same directory in source.