Skip to main content

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

Project description

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)

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)

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)

0.0.6 (2022-08-18)

0.0.5 (2021-11-06)

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)

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kodi_nfo_generator-0.0.17.tar.gz (36.5 kB view details)

Uploaded Source

File details

Details for the file kodi_nfo_generator-0.0.17.tar.gz.

File metadata

  • Download URL: kodi_nfo_generator-0.0.17.tar.gz
  • Upload date:
  • Size: 36.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.10

File hashes

Hashes for kodi_nfo_generator-0.0.17.tar.gz
Algorithm Hash digest
SHA256 1f3322f63d3124a37caa047db84c7a33e5a875133b9e323dec37a1e74b991836
MD5 3845d45a75c34f5e2792f288b3b8d1cb
BLAKE2b-256 4fe3f0575c77aaea587cc95535f6b136f19a31f72f2bdb2ca351558024f3d01b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page