Skip to content

Home

CI codecov Tests Python Platforms GitHub License GitHub Release Dependencies

pymp4v2 - Python Bindings for mp4v2 Library

Python bindings for the mp4v2 library, providing a high-level interface for working with MP4 multimedia containers.

Features

  • Full access to mp4v2 library functionality
  • Support for reading, writing, and modifying MP4 files
  • Cross-platform support (Windows and Linux)
  • Pythonic API with proper error handling
  • Automatic memory management
  • Type annotations and stub files for better IDE support

Requirements

Build Dependencies

  • Python 3.9+
  • C++17 compatible compiler
  • CMake 3.14+
  • Ninja build system
  • Git

Python Dependencies

  • setuptools >= 42
  • wheel
  • scikit-build >= 0.13
  • cmake >= 3.14
  • ninja
  • pybind11 >= 2.6.0
  • pybind11-stubgen >= 2.5.5

Installation

See the Installation file.

Usage

See the Usage file.

API Reference

See the API file.

Running Tests

To run the test suite, you'll need to install the development dependencies:

pip install -e .[dev]
pytest tests/

Or use the built-in test runner:

python -m pytest tests/

Contributing

See the CONTRIBUTING.md file.

License

This project is licensed under the terms of the license included in the repository. See the LICENSE file for details.

Acknowledgments

  • mp4v2 library authors for the underlying C++ library
  • Pybind11 team for the excellent binding infrastructure
  • The Python community for excellent tooling and support

Support

If you encounter any issues or have questions, please file an issue on the GitHub issue tracker.

Changelog

See the CHANGELOG.md file for a history of changes to the project.