Skip to main content

Guessit-fork

Latest Version LGPLv3 License Codecov semantic-release

Guessit-fork is a python library that extracts as much information as possible from a video filename.

It has a very powerful matcher that allows to guess properties from a video using its filename only. This matcher works with both movies and tv shows episodes.

For example, Guessit-fork can do the following:

$ guessit-fork "Treme.1x03.Right.Place,.Wrong.Time.HDTV.XviD-NoTV.avi"
For: Treme.1x03.Right.Place,.Wrong.Time.HDTV.XviD-NoTV.avi
Guessit-fork found: {
    "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"])

More information is available at masudranaxpert.github.io/Guessit-fork.

Fork Credits

This repository is maintained as Guessit-fork by masudranaxpert:

Original upstream project and credits:

Support

This fork is hosted on GitHub for custom updates and maintenance. For upstream issues and original implementation details, see guessit-io/guessit.

Guessit-fork relies on Rebulk project for pattern and rules registration.

License

Guessit-fork is licensed under the LGPLv3 license.

Metadata

Release files for guessit-fork 4.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for guessit-fork 4.0.3
File Size Uploaded
guessit_fork-4.0.3.tar.gz 141.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for guessit-fork 4.0.3
File Interpreter ABI Platform
guessit_fork-4.0.3-py3-none-any.whl Python 3 none any Details

Total release size: 308.5 kB

Release files / guessit_fork-4.0.3.tar.gz

Download URL guessit_fork-4.0.3.tar.gz
Size 141.6 kB
Tags Source
SHA-256 checksum
How to use checksums
1e8da0a83e97f0e7905f14978087186f4d7394e7a4c2cb72c58c717626700990
BLAKE2b-256 checksum
How to use checksums
a7793ff037be7b39bd4f87ca288666cb92ff67a1034f45478b7a6bed6e627dc0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 27, 2026.

Transparency log

Release files / guessit_fork-4.0.3-py3-none-any.whl

Download URL guessit_fork-4.0.3-py3-none-any.whl
Size 166.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7acab6c53d6caf50f71bf1ff1a9eb1f89f6292410b94817b96df7cbaf3fa2aa6
BLAKE2b-256 checksum
How to use checksums
9870280a91a0a654cb226d070c2dd648aa5f2cdd414bc5bc7ee849fdbcbc4e7e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 27, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

4.0.3 This release

2 release files

4.0.2

2 release files

4.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page