kodi-nfo-generator 0.0.17

Simple Python-based command-line tool to generate .nfo files for movies and TV shows for Kodi.

The kodi_nfo_generator is a simple Python-based command-line tool that allows you to generate .nfo files for movies/TV shows that Kodi can use for its library.

This tool is aimed at people that manually curate their movie databases, in order to avoid using scrapers that may pull in the wrong information (or none at all). All the user has to do is place an ID file alongside their movie files, the default is *.imdb, containing the unique IMDB movie ID (or full IMDB movie URL). The tool will then scour the movie directories for these files and pull in the information and create the .nfo files in the same location.

It is also possible to pull in information about episodes of a TV series (–episodes). Though this is slow due to a lot more API calls. In this case, .nfo files for TV episodes are being generated. The episodes can either be in the same directory of the .nfo file of the series or in sub-directories.

Changelog

0.0.17 (2025-04-22)

• minor bugfixes and support for MPAA ratings (thanks to Daniel Quinn, PR https://github.com/fracpete/kodi-nfo-generator/pull/9)

0.0.16 (2025-01-18)

• switched to underscores in project name

• series episode extraction (episode-item-wrapper based) now handles ttep_ep_([0-9]+) as well as ttep_ep([0-9]+)

0.0.15 (2024-09-29)

• added experimental extraction of episode information from JSON (if available), which take precedence over information from HTML tags

• added experimental –multi_episodes flag, which outputs a multi-episode.nfo file with all the episode details rather than one .nfo per episode

• the –episode_pattern option now allows specifying multiple patterns (e.g., ?x??* and ??x??*)

0.0.14 (2024-03-08)

• now checking whether aria-label attribute is present in rating tag for series (https://github.com/fracpete/kodi-nfo-generator/issues/7)

0.0.13 (2023-08-20)

• now only downloading episode data for seasons that are also on disk rather than all available ones

0.0.12 (2023-08-20)

• unescaping HTML entities in the JSON data when loading it

0.0.11 (2023-08-19)

• seasons can be extracted now from button-based navigation, as well as the older style “select”-based one.

• episode data can be extract from episode-item-wrapper tags as well now

0.0.10 (2023-04-16)

• using @type in JSON data to check whether episode data available (i.e., when TVSeries)

0.0.9 (2023-01-06)

• using download-missing no longer generates Ignoring unhandled fanart type: download-missing message when fanart already present (just an output bug).

• improved checks for existing .nfo files to reduce IMDB requests

• added kodi-nfo-rename tool for renaming files using regular expressions (e.g., files of TV shows)

• the kodi-nfo-gen tool now has additional options for matching episode files rather than using hardcoded defaults: –episode_pattern, –season_group, –episode_group.

0.0.8 (2023-01-04)

• added kodi-nfo-guess tool that performs online database searches for directories that miss meta-files, like .imdb, which the kodi-nfo-gen tool uses as input.

0.0.7 (2023-01-03)

• adding user-agent to request headers now (https://github.com/fracpete/kodi-nfo-generator/pull/6)

• only making IMDB request when –overwrite flag present or .nfo not present, to avoid making too many calls to IMDB

• the –delay no longer applies when not writing a file

• fixed TV show .nfo generation (https://github.com/fracpete/kodi-nfo-generator/issues/1)

• added download-missing choice for downloading fanart only when it is missing locally (download always performs a download)

0.0.6 (2022-08-18)

• not all movie meta-data contains the actor field, now checking whether present (https://github.com/fracpete/kodi-nfo-generator/pull/4)

0.0.5 (2021-11-06)

• setup.py excludes versions of beautifulsoup that don’t work (https://github.com/fracpete/kodi-nfo-generator/issues/2)

• added experimental support for generating .nfo output for TV series episodes (https://github.com/fracpete/kodi-nfo-generator/issues/1)

0.0.4 (2021-05-29)

• ratingValue is now set as string, not float; better handling when preflang_title not available

0.0.3 (2021-03-11)

• restricting beautifulsoup version to <=4.6.0 as newer versions fail: https://github.com/fracpete/kodi-nfo-generator/issues/2

0.0.2 (2020-02-09)

• added ability to export movie IDs to a CSV file using kodi-nfo-export

• added ability to import movie IDs from a CSV file using kodi-nfo-import

• kodi-nfo-gen now handles movies that only have limited information available (e.g., no plot or no image)

• added interactive mode to tools (–interactive)

0.0.1 (2020-02-08)

• initial release, only supports IMDB for the time being