olefile
Python package to parse, read and write Microsoft OLE2 files (Structured Storage or Compound Document, Microsoft Office)
Decision gist · record as of 2026-08-14
Yes, if you need to work with OLE2 files. The package is stable, dependency-free, and widely used (top 1000 on PyPI). Maintenance is dormant but not abandoned; the last commit was recent and there are no known vulnerabilities. Install only if your use case genuinely requires OLE file handling—it is not a general-purpose tool.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Installation is straightforward with no runtime dependencies.
- The package is marked dormant (last release 2023-12-01, last commit 2024-10-28) but remains stable and widely used; maintenance appears minimal but the codebase is mature and archived status is false.
License · maintenance · safety
BSD (permissive) — BSD license (permissive) permits commercial and private use with minimal restrictions; you must retain copyright notices in source and binary distributions.
last release 2023-12-01 (987 days) · last repo commit 2024-10-28 · 270 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 26,018,738 downloads/mo, #893 on PyPI
Alternatives
Verify before relying
pip install olefile
import olefile
ole = olefile.OleFileIO('document.doc')
for entry in ole.listdir():
print(entry)
ole.close()- Whether the package handles all OLE2 variants mentioned (vbaProject.bin, Image Composer, FlashPix, Outlook, StickyNotes, microscopy formats, McAfee quarantine) with equal robustness
- Current state of context manager support (mentioned for v0.46 but not confirmed in v0.47 release notes)
What it is and what it does
olefile is a pure-Python library for working with Microsoft OLE2 (Compound File Binary Format) documents. It reads and writes the binary structure used by Microsoft Office 97-2003 files (.doc, .xls, .ppt), Outlook messages, and dozens of other legacy and specialized formats. The library exposes streams and storages within OLE files as a navigable hierarchy, allowing you to extract metadata, read embedded data, and modify file contents.
The package is designed primarily for developers building tools that need to inspect or manipulate OLE files—particularly useful for malware analysis, forensics, and document processing. It has no external dependencies, works across Python 2.7 and Python 3.5+, and integrates with PIL/Pillow when image handling is needed. The codebase is stable and mature, though releases are infrequent.
Use it for
- Extract metadata and streams from legacy Microsoft Office documents for archival or migration purposes
- Analyze OLE file structure in malware forensics and security research workflows
- Parse vbaProject.bin files to inspect VBA macros embedded in Office 2007+ documents
- Read Outlook .msg files and other messaging formats to recover or audit message content
- Process specialized OLE-based formats (microscopy images, FlashPix, Zeiss ZVI) in scientific workflows
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to work with OLE2 files.
The package is stable, dependency-free, and widely used (top 1000 on PyPI). Maintenance is dormant but not abandoned; the last commit was recent and there are no known vulnerabilities. Install only if your use case genuinely requires OLE file handling—it is not a general-purpose tool.
Install
olefile on PyPI
Before you install
Installation is straightforward with no runtime dependencies. The package is marked dormant (last release 2023-12-01, last commit 2024-10-28) but remains stable and widely used; maintenance appears minimal but the codebase is mature and archived status is false.
License in practice
BSD license (permissive) permits commercial and private use with minimal restrictions; you must retain copyright notices in source and binary distributions.
Quickstart
pip install olefile
import olefile
ole = olefile.OleFileIO('document.doc')
for entry in ole.listdir():
print(entry)
ole.close()Verify before relying
- Whether the package handles all OLE2 variants mentioned (vbaProject.bin, Image Composer, FlashPix, Outlook, StickyNotes, microscopy formats, McAfee quarantine) with equal robustness
- Current state of context manager support (mentioned for v0.46 but not confirmed in v0.47 release notes)
Package facts
| License | BSD permissive |
| Python support | Supports the current Python release >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.* |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Dormant 987 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 26,018,738 / month, #893 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: Information TechnologyIntended Audience :: Science/ResearchIntended Audience :: System AdministratorsLicense :: OSI Approved :: BSD LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 2Programming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Software Development :: Libraries :: Python Modules |
Evidence: olefile-0.47-py2.py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “parse OLE2 compound files”
- olefileolefile parses, reads, and writes Microsoft OLE2 compound files…
- oletoolsoletools is a suite of Python tools to extract, analyze, and detect…
- compoundfilesReads and parses Microsoft Compound File Binary format (CFB), OLE…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also compoundfiles · oletools · types-olefile · pefile · pcodedmp · msoffcrypto-tool · python-oxmsg · docx · textract