{"id":45858,"library":"pyaaf2","title":"pyaaf2","description":"pyaaf2 is a Python module for reading and writing Advanced Authoring Format (AAF) files, a multimedia file format used in professional video editing. As of version 1.7.1, it supports Python >=2.7 and 3.7+. The library is maintained with periodic updates for bug fixes and format improvements.","status":"active","version":"1.7.1","language":"python","source_language":"en","source_url":"https://github.com/markreidvfx/pyaaf2","tags":["aaf","multimedia","video-editing","file-format"],"install":[{"cmd":"pip install pyaaf2","lang":"bash","label":"PyPI install"}],"dependencies":[{"reason":"Used for Python 2/3 compatibility in some internal code","package":"six","optional":false}],"imports":[{"wrong":"from aaf2 import AAFFile","symbol":"AAFFile","correct":"from aaf2 import AAFFile"}],"quickstart":{"code":"import aaf2\n\n# Open an existing AAF file\nwith aaf2.open('example.aaf', 'r') as f:\n    for mob in f.content.mobs:\n        print(mob.name)\n\n# Create a new AAF file\nwith aaf2.open('output.aaf', 'w') as f:\n    # ... add content ...\n    pass","lang":"python","description":"Basic read and write operations with aaf2.open(). Use 'r' for reading, 'w' for writing."},"warnings":[{"fix":"Do not rely on 'w' for safe updates; always create backups.","message":"The open() function with write mode 'w' will overwrite an existing file without warning. Use 'a' to append or check existence manually.","severity":"gotcha","affected_versions":"all"},{"fix":"Upgrade to Python 3.7 or later.","message":"Python 2.7 support was deprecated in recent versions. Ensure you use Python 3.7+ for best compatibility.","severity":"deprecated","affected_versions":">=1.7.0"},{"fix":"Use conditional checks: if mob.name: print(mob.name)","message":"When reading AAF files, some properties may return empty strings or None if not set. Always check for None before accessing methods.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'1.7.1':28 '2.7':32 '3.7':34 'aaf':14,48 'advanc':11 'author':12 'bug':43 'edit':24,52 'file':15,18,54 'file-format':53 'fix':44 'format':13,19,46,55 'improv':47 'librari':36 'maintain':38 'modul':6 'multimedia':17,49 'period':40 'profession':22 'pyaaf2':1,2 'python':5,31 'read':8 'support':30 'updat':41 'use':20 'version':27 'video':23,51 'video-edit':50 'write':10","created_at":"2026-06-07T12:57:04.802839+00:00","updated_at":"2026-06-07T12:57:04.802839+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'AAFFile' from 'aaf2' (/tmp/tmp53gwpi4v/venv/lib/python3.12/site-packages/aaf2/__init__.py)"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/markreidvfx/pyaaf2","github":"https://github.com/markreidvfx/pyaaf2","docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["storage"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}