Skip to content

Repository files navigation

# File Entropy Visualizer — Offline Malware Analysis (Static) Tool

[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
[![Offline](https://img.shields.io/badge/mode-offline%20first-important.svg)](#)
[![secintel](https://img.shields.io/badge/schema-secintel%20v1-purple.svg)](https://github.com/reshot2005/secintel-core)
[![GitHub](https://img.shields.io/badge/github-reshot2005%2Ffile-entropy-visualizer-black.svg)](https://github.com/reshot2005/file-entropy-visualizer)

> **Shannon entropy visualization to detect packed/encrypted regions — malware packing analysis and binary entropy mapping offline.**

**Category:** Malware Analysis (Static)  
**Collection phase tool:** 3/8  
**Schema:** [secintel-core](https://github.com/reshot2005/secintel-core) v1  
**Repository:** https://github.com/reshot2005/file-entropy-visualizer  
**Author account:** [reshot2005](https://github.com/reshot2005)

## Why File Entropy Visualizer ranks for security search

File Entropy Visualizer is an **offline-first**, research-grade **malware analysis (static)** utility designed for practitioners who need reproducible analysis without uploading sensitive artifacts to SaaS scanners. It emits structured findings through the shared **secintel** evidence taxonomy (OBSERVED / DERIVED / INFERRED / CORRELATED / VERIFIED) so results are auditable, exportable, and CI-friendly.

### Primary SEO keywords
`file entropy, packer detection, Shannon entropy, encrypted sections, malware packing`

### Topics
`malware-analysis` `reverse-engineering` `static-analysis` `cybersecurity` `threat-intelligence` `ioc` `security-tools` `python` `offline-security` `yara` `entropy` `packers`

## What problem does this solve?

Compute per-region Shannon entropy to highlight packed or encrypted areas commonly seen in malware.

Entropy-first packing lens with structured findings.

## Key features

- Shannon entropy mapping
  • Packed/encrypted region hints

  • Visual/report outputs

  • Static-only safety

  • Binary triage aid

    Ideal use cases

    • Spot packed malware
  • Guide unpacking effort

  • Compare section entropy

    Who should use this

    • Security engineers & AppSec / NetSec specialists
    • SOC / DFIR / malware analysts (as applicable)
    • Bug bounty hunters and penetration testers
    • DevSecOps teams needing offline/air-gapped tooling
    • Students and researchers learning malware analysis (static)

    Quick start

    git clone https://github.com/reshot2005/file-entropy-visualizer.git
    cd file-entropy-visualizer
    python3.12 -m venv .venv
    source .venv/bin/activate  # Windows: .venv\Scripts\Activate.ps1
    pip install -e ../secintel-core  # or: pip install -e git+https://github.com/reshot2005/secintel-core.git#egg=secintel-core
    pip install -e ".[dev]"
    
    file-entropy-visualizer analyze sample_data --json
    file-entropy-visualizer analyze sample_data --html report.html
    file-entropy-visualizer version

    Exports for interoperability

    file-entropy-visualizer analyze sample_data \
      --json --html report.html --csv findings.csv --sarif results.sarif

    Evidence quality & reproducibility

    • Findings follow secintel classification rules (confidence only where schema allows).
    • Provenance includes tool version, config hash, and input integrity metadata.
    • Set SECINTEL_SOURCE_DATE_EPOCH for deterministic timestamps in CI.
    export SECINTEL_SOURCE_DATE_EPOCH=1704067200
    file-entropy-visualizer analyze sample_data --json

    Development

    ruff check src tests
    mypy src
    pytest

    Related tools in this collection

    Browse more offline security research tools by reshot2005: network security, web AppSec, DevSecOps, digital forensics, and static malware analysis — each in its own public repository with the same secintel reporting contract.

    License

    MIT — free for research, education, and commercial use with attribution preserved.


    Discoverability blurb (search engines & GitHub)

    File Entropy Visualizer (file-entropy-visualizer) — Shannon entropy visualization to detect packed/encrypted regions — malware packing analysis and binary entropy mapping offline. Search terms: file entropy, packer detection, Shannon entropy, encrypted sections, malware packing. Open-source, MIT-licensed, Python 3.12, offline cybersecurity tool by reshot2005.

About

Shannon entropy visualization to detect packed/encrypted regions — malware packing analysis and binary entropy mapping offline.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages