Assemblyline-service-oletools

An Assemblyline service that inspects Microsoft Office and other OLE/XML documents, using py-oletools and hachoir to extract metadata and network information…

  • Security
  • Tools & Utilities
An Assemblyline service that inspects Microsoft Office and other OLE/XML documents, using py-oletools and hachoir to extract metadata and network information and flag suspicious macros and embedded threats.

Platform availability

Available on 0 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

38/100 Low

Maintained
72last commit 17 days ago
Popular
102 GitHub stars
Easy to install
250 install platforms, install notes, Docker image
Light to run
108 GB minimum RAM
GitHub stars
2
Open issues
0
Last commit
2026-11-04
Latest release
v4.8.0.stable0
Activity
stale

Checked yesterday - source: GitHub (cybercentrecanada/assemblyline-service-oletools)

Resources & Compatibility

Minimum requirements: 8 GB RAM, 4 CPU core(s). ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Deployment within Assemblyline This is a service module for the Assemblyline malware-analysis platform. Deploy the cccs/assemblyline-service-oletools Docker image inside an Assemblyline deployment; it is designed to run within Assemblyline rather than as a standalone application. source

Fetched 48 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Can the OLEtools service be run standalone outside an Assemblyline deployment?

No. It is a service module for Assemblyline and should be deployed inside an Assemblyline deployment as the cccs/assemblyline-service-oletools Docker image.

How can I stop the OLEtools service from flagging very large macro sections?

Set MACRO_SCORE_MAX_FILE_SIZE to the byte threshold. Macro sections larger than that value are not flagged in the results.

When does the OLEtools service extract OLE metadata as a new file?

Set METADATA_SIZE_TO_EXTRACT to the size limit in bytes. If the OLE metadata is larger than that limit, the service extracts the metadata content as a new file.

How can I suppress false-positive IOC strings reported by the OLEtools service?

Add the IOC substring to IOC_PATTERN_SAFELIST or the exact IOC to IOC_EXACT_SAFELIST. The service ignores those IOCs unless deep scan mode is enabled.

Answers sourced from github.com

Community

Collected 48 days ago - public community threads