pymkv2
pymkv2 is a Python wrapper for mkvmerge and other tools in the MKVToolNix suite. It provides support for muxing, splitting, linking, chapters, tags, and attachments through the use of mkvmerge.
About pymkv2
it's a fork of the pymkv project. pymkv2 is a Python 3 library for manipulating MKV files with mkvmerge. Constructing mkvmerge commands manually can quickly become confusing and complex. To remedy this, I decided to write this library to make mkvmerge more scriptable and easier to use. Please open new issues for any bugs you find, support is greatly appreciated!
Installation
mkvmerge must be installed on your computer, it is needed to process files when creating MKV objects. It is also recommended to add it to your $PATH variable but a different path can be manually specified. mkvmerge can be found and downloaded from here or from most package managers.
To install pymkv from PyPI, use the following command:
$ pip install pymkv2
You can also clone the repo and run the following command in the project root to install the source code as editable:
$ pip install -e .
Language code utilities
pymkv exposes a normalized API for comparing and translating language codes
across ISO 639-1, /B, /T, 639-3, BCP 47, and English language names. Use these
helpers instead of comparing language strings directly — language_ietf="zh-Hans"
and language="chi" should match, and they do via languages_match.
from pymkv import (
MKVFile,
get_iso639_2,
languages_match,
language_equivalents,
normalize_language,
)
get_iso639_2("English") # "eng"
get_iso639_2("fra") # "fre" (canonical /B)
normalize_language("zh-Hans") # "chi" (BCP 47 subtag stripped)
languages_match("zho", "zh") # True
language_equivalents("eng") # frozenset({"eng", "en"})
# MKVTrack setter is now lenient — any recognized form is accepted and
# canonicalized to /B on store.
mkv = MKVFile("path/to/file.mkv")
track = mkv.tracks[1]
track.language = "Chinese" # stored as "chi"
track.matches_language("zh") # True (works against language_ietf too)
track.effective_language # "chi" — normalized /B
Documentation
The documentation for pymkv can be found here or in the project's docstrings.
1 maintainer
Metadata
1 maintainer
Release files for pymkv2 2.3.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| pymkv2-2.3.2.tar.gz | 79.0 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pymkv2-2.3.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 131.8 kB
Release files / pymkv2-2.3.2.tar.gz
| Download URL | pymkv2-2.3.2.tar.gz |
|---|---|
| Size | 79.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0da8f3770276e7bfa8293d36e9b0c391681069f3f153b63d1e7f79d76fc00704
|
|
BLAKE2b-256 checksum How to use checksums |
c8852aedb77182bb421e695c18ce6686ddf09452bd24c53cf47a6b0f0c0dc21d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.12 {"installer":{"name":"uv","version":"0.11.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / pymkv2-2.3.2-py3-none-any.whl
| Download URL | pymkv2-2.3.2-py3-none-any.whl |
|---|---|
| Size | 52.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
20ef62bc9c3d4ef52d4a4c2b8f5f7987e408c021a11a8f81be3042d5ad689b49
|
|
BLAKE2b-256 checksum How to use checksums |
f84ed3979a5f1cdbe238e991601097873223492747257425d5fc3f17dd695425
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.12 {"installer":{"name":"uv","version":"0.11.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for pymkv2 2.3.2
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
