Guessit-fork

Guessit-fork is a Python library that extracts structured metadata from video filenames. It works for both movie and episode naming patterns and supports rich, rule-based parsing.

Install

pip install guessit-fork

Quick Example

guessit-fork "Treme.1x03.Right.Place,.Wrong.Time.HDTV.XviD-NoTV.avi"

Example output:

{
  "title": "Treme",
  "season": 1,
  "episode": 3,
  "episode_title": "Right Place, Wrong Time",
  "source": "HDTV",
  "video_codec": "Xvid",
  "release_group": "NoTV",
  "container": "avi",
  "mimetype": "video/x-msvideo",
  "type": "episode"
}

Python Usage

from guessit_fork import guessit

result = guessit("Treme.1x03.Right.Place,.Wrong.Time.HDTV.XviD-NoTV.avi")
print(result["title"])

Documentation

• Python Usage
• Properties
• Sources
• Configuration
• Migration (2.x to 3.x)
• Migration (1.x to 2.x)

Support

This fork is maintained at masudranaxpert/Guessit-fork. Please open an issue for bugs, regressions, or feature requests.

License

Guessit-fork is licensed under LGPLv3.