MIFpy

mifpy is a lightweight Python library for the Movie Information Format (.mif), a ZIP-based container format for movie metadata, subtitles, actor appearance timelines, and associated assets.

Features

• Load and save .mif archives using Python zipfile
• Validate required package files and formats
• Parse manifest.ini, meta.ini, appearances.json, and subtitles.srt
• Add content assets under content/
• CLI support: inspect, extract, and create

Package structure

A valid .mif archive contains:

• manifest.ini
• meta.ini
• subtitles.srt
• appearances.json
• content/ (optional)

Installation

Install with Poetry:

poetry install

Usage

from mifpy import MIFPackage

pkg = MIFPackage.create(
    meta={"title": "The Matrix", "year": 1999, "runtime_ms": 8160000},
    subtitles="1\n00:00:00,000 --> 00:00:02,000\nWake up, Neo.\n",
    appearances={
        "actors": {
            "keanu_reeves": {
                "name": "Keanu Reeves",
                "image": "content/keanu.png",
            }
        },
        "appearances": [
            {"actor": "keanu_reeves", "start_ms": 1000, "end_ms": 10000}
        ],
    },
)

pkg.add_content_file("keanu.png", b"<raw-image-bytes>")
pkg.save("movie.mif")

CLI

mifpy inspect movie.mif
mifpy extract movie.mif ./out
mifpy create sample.mif

Testing

Run tests with:

poetry run pytest