How nolze/msoffcrypto-tool works
msoffcrypto-tool is a Python library and CLI for decrypting Office documents, with experimental OOXML encryption. The principal workflow identifies an input format, loads a password or key, verifies it where supported, and decrypts to a caller-provided output; the CLI also exposes encryption and encrypted-file testing. Format handlers implement OOXML and legacy Word, Excel, and PowerPoint processing, backed by shared parsing and scheme-specific cryptography. The README documents key options and supported schemes; unsampled handler details and some CLI wiring are not inferred.
Main entry points: xls97.py Excel 97 handler · __init__.py Format detection · ooxml.py OOXML handler · doc97.py Word 97 handler
Components 17
Entry points
- CLI
msoffcrypto/__main__.py - Format detection
msoffcrypto/__init__.py
Format handlers
- File interface
msoffcrypto/format/base.py - Header parsing
msoffcrypto/format/common.py - OOXML handler
msoffcrypto/format/ooxml.py - Word 97 handler
msoffcrypto/format/doc97.py - Excel 97 handler
msoffcrypto/format/xls97.py - PowerPoint 97 handler
msoffcrypto/format/ppt97.py
Cryptographic methods
- Agile encryption
msoffcrypto/method/ecma376_agile.py - Standard encryption
msoffcrypto/method/ecma376_standard.py - Extensible encryption
msoffcrypto/method/ecma376_extensible.py - Office RC4
msoffcrypto/method/rc4.py - RC4 CryptoAPI
msoffcrypto/method/rc4_cryptoapi.py - XOR obfuscation
msoffcrypto/method/xor_obfuscation.py
OOXML container
- Encrypted OLE writer
msoffcrypto/method/container/ecma376_encrypted.py
Other components
- User or caller
- Output file or buffer
Connections 24
- User or caller → CLI: runs command
README.md - User or caller → Format detection: opens file
README.md - CLI → Format detection: selects format
- Format detection → OOXML handler: detects OOXML
msoffcrypto/__init__.py - Format detection → Word 97 handler: detects Word
msoffcrypto/__init__.py - Format detection → Excel 97 handler: detects Excel
msoffcrypto/__init__.py - Format detection → PowerPoint 97 handler: detects PowerPoint
msoffcrypto/__init__.py - Word 97 handler → Header parsing: parses headers
msoffcrypto/format/doc97.py - Excel 97 handler → Header parsing: parses headers
msoffcrypto/format/xls97.py - PowerPoint 97 handler → Header parsing: parses headers
msoffcrypto/format/ppt97.py - OOXML handler → Agile encryption: uses scheme
msoffcrypto/format/ooxml.py - OOXML handler → Standard encryption: uses scheme
msoffcrypto/format/ooxml.py - Word 97 handler → Office RC4: uses cipher
msoffcrypto/format/doc97.py - Word 97 handler → RC4 CryptoAPI: uses cipher
msoffcrypto/format/doc97.py - Excel 97 handler → Office RC4: uses cipher
msoffcrypto/format/xls97.py - Excel 97 handler → RC4 CryptoAPI: uses cipher
msoffcrypto/format/xls97.py - Excel 97 handler → XOR obfuscation: uses method
msoffcrypto/format/xls97.py - PowerPoint 97 handler → RC4 CryptoAPI: uses cipher
msoffcrypto/format/ppt97.py - Agile encryption → Encrypted OLE writer: uses container
msoffcrypto/method/ecma376_agile.py - OOXML handler → Output file or buffer: writes decrypted data
README.md - OOXML handler → Output file or buffer: writes encrypted data
README.md - Word 97 handler → Output file or buffer: writes decrypted data
README.md - Excel 97 handler → Output file or buffer: writes decrypted data
README.md - PowerPoint 97 handler → Output file or buffer: writes decrypted data
README.md