# mcmilk/7-zip-zstd architecture

> Architecture diagram of the GitHub repository mcmilk/7-zip-zstd, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mcmilk/7-zip-zstd
- Repository: https://github.com/mcmilk/7-zip-zstd

## Overview

7-Zip ZS is a 7-Zip fork that adds compression codecs, encryption methods, and hashers, distributed either as a complete GUI/Explorer setup or as a codec plugin. The principal workflow is a user invoking the CLI or GUI to open or create an archive, which delegates format handling and compression or encryption before extracting or writing files. The README documents the added capabilities; sampled sources show CLI and extraction behavior, but not the full codec and archive dispatch paths, so those links are marked unverified where needed.

Main entry points: [`CPP/7zip/Archive`](https://github.com/mcmilk/7-zip-zstd/tree/master/CPP/7zip/Archive) (Archive handlers), [`CPP/7zip/Compress`](https://github.com/mcmilk/7-zip-zstd/tree/master/CPP/7zip/Compress) (Codec integration), [`CPP/7zip/UI/Console/Main.cpp`](https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/UI/Console/Main.cpp) (Command line), [`CPP/7zip/Bundles/SFXSetup/ExtractEngine.cpp`](https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/Bundles/SFXSetup/ExtractEngine.cpp) (SFX extractor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_cli["Command line<br/>[Main.cpp]"]
  node_gui["File manager<br/>[App.cpp]"]
  node_sfx["SFX extractor<br/>[ExtractEngine.cpp]"]
  node_installer["Setup installer<br/>[7zipInstall.c]"]
end

subgraph group_archive["Archive formats"]
  node_archive_formats["Archive handlers"]
  node_format7z["7z format<br/>[7zHandler.cpp]"]
  node_zip["ZIP format<br/>[ZipHandler.cpp]"]
  node_tar["TAR format<br/>[TarHandler.cpp]"]
  node_extract_callback["Extraction callback"]
end

subgraph group_codecs["Compression codecs"]
  node_codec_registry["Codec integration"]
  node_zstd["Zstandard<br/>[zstd_compress.c]"]
  node_brotli["Brotli"]
  node_lz4["LZ4<br/>[lz4.c]"]
  node_lizard["Lizard<br/>[lizard_compress.c]"]
  node_fast_lzma["Fast LZMA2<br/>[lzma2_enc.c]"]
end

subgraph group_security["Security and hashes"]
  node_crypto["Encryption methods"]
  node_hashers["Hash algorithms"]
end

subgraph group_platform["Runtime support"]
  node_streams["Stream utilities<br/>[FileStreams.cpp]"]
  node_cpu["CPU and types<br/>[CpuArch.h]"]
  node_core_types["Core types<br/>[7zTypes.h]"]
end

node_user(("User"))

node_user -->|"invokes"| node_cli
node_user -.->|"uses"| node_gui
node_user -->|"installs"| node_installer
node_cli -.->|"opens archives"| node_archive_formats
node_gui -.->|"browses archives"| node_archive_formats
node_sfx -->|"opens archive"| node_archive_formats
node_sfx -->|"extracts through"| node_extract_callback
node_archive_formats -.->|"supports"| node_format7z
node_archive_formats -.->|"supports"| node_zip
node_archive_formats -.->|"supports"| node_tar
node_archive_formats -.->|"uses codecs"| node_codec_registry
node_codec_registry -.->|"registers"| node_zstd
node_codec_registry -.->|"registers"| node_brotli
node_codec_registry -.->|"registers"| node_lz4
node_codec_registry -.->|"registers"| node_lizard
node_codec_registry -.->|"registers"| node_fast_lzma
node_archive_formats -.->|"supports encryption"| node_crypto
node_cli -.->|"offers hashers"| node_hashers
node_archive_formats -.->|"uses streams"| node_streams
node_zstd -.->|"uses CPU support"| node_cpu
node_cpu -->|"includes"| node_core_types

click node_cli "https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/UI/Console/Main.cpp"
click node_gui "https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/UI/FileManager/App.cpp"
click node_sfx "https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/Bundles/SFXSetup/ExtractEngine.cpp"
click node_archive_formats "https://github.com/mcmilk/7-zip-zstd/tree/master/CPP/7zip/Archive"
click node_format7z "https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/Archive/7z/7zHandler.cpp"
click node_zip "https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/Archive/Zip/ZipHandler.cpp"
click node_tar "https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/Archive/Tar/TarHandler.cpp"
click node_codec_registry "https://github.com/mcmilk/7-zip-zstd/tree/master/CPP/7zip/Compress"
click node_zstd "https://github.com/mcmilk/7-zip-zstd/blob/master/C/zstd/zstd_compress.c"
click node_brotli "https://github.com/mcmilk/7-zip-zstd/blob/master/C/brotli/br_compress_fragment.c"
click node_lz4 "https://github.com/mcmilk/7-zip-zstd/blob/master/C/lz4/lz4.c"
click node_lizard "https://github.com/mcmilk/7-zip-zstd/blob/master/C/lizard/lizard_compress.c"
click node_fast_lzma "https://github.com/mcmilk/7-zip-zstd/blob/master/C/fast-lzma2/lzma2_enc.c"
click node_crypto "https://github.com/mcmilk/7-zip-zstd/tree/master/CPP/7zip/Crypto"
click node_hashers "https://github.com/mcmilk/7-zip-zstd/tree/master/C/hashes"
click node_extract_callback "https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/Bundles/SFXSetup/ExtractCallbackSfx.h"
click node_streams "https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/Common/FileStreams.cpp"
click node_cpu "https://github.com/mcmilk/7-zip-zstd/blob/master/C/CpuArch.h"
click node_core_types "https://github.com/mcmilk/7-zip-zstd/blob/master/C/7zTypes.h"
click node_installer "https://github.com/mcmilk/7-zip-zstd/blob/master/C/Util/7zipInstall/7zipInstall.c"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_gui,node_sfx,node_installer,node_user toneBlue
class node_archive_formats,node_format7z,node_zip,node_tar,node_extract_callback toneAmber
class node_codec_registry,node_zstd,node_brotli,node_lz4,node_lizard,node_fast_lzma toneMint
class node_crypto,node_hashers toneRose
class node_streams,node_cpu,node_core_types toneIndigo
```

## Components

### User interfaces

- [Command line](https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/UI/Console/Main.cpp): `CPP/7zip/UI/Console/Main.cpp`
- [File manager](https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/UI/FileManager/App.cpp): `CPP/7zip/UI/FileManager/App.cpp`
- [SFX extractor](https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/Bundles/SFXSetup/ExtractEngine.cpp): `CPP/7zip/Bundles/SFXSetup/ExtractEngine.cpp`
- [Setup installer](https://github.com/mcmilk/7-zip-zstd/blob/master/C/Util/7zipInstall/7zipInstall.c): `C/Util/7zipInstall/7zipInstall.c`

### Archive formats

- [Archive handlers](https://github.com/mcmilk/7-zip-zstd/tree/master/CPP/7zip/Archive): `CPP/7zip/Archive`
- [7z format](https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/Archive/7z/7zHandler.cpp): `CPP/7zip/Archive/7z/7zHandler.cpp`
- [ZIP format](https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/Archive/Zip/ZipHandler.cpp): `CPP/7zip/Archive/Zip/ZipHandler.cpp`
- [TAR format](https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/Archive/Tar/TarHandler.cpp): `CPP/7zip/Archive/Tar/TarHandler.cpp`
- [Extraction callback](https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/Bundles/SFXSetup/ExtractCallbackSfx.h): `CPP/7zip/Bundles/SFXSetup/ExtractCallbackSfx.h`

### Compression codecs

- [Codec integration](https://github.com/mcmilk/7-zip-zstd/tree/master/CPP/7zip/Compress): `CPP/7zip/Compress`
- [Zstandard](https://github.com/mcmilk/7-zip-zstd/blob/master/C/zstd/zstd_compress.c): `C/zstd/zstd_compress.c`
- [Brotli](https://github.com/mcmilk/7-zip-zstd/blob/master/C/brotli/br_compress_fragment.c): `C/brotli/br_compress_fragment.c`
- [LZ4](https://github.com/mcmilk/7-zip-zstd/blob/master/C/lz4/lz4.c): `C/lz4/lz4.c`
- [Lizard](https://github.com/mcmilk/7-zip-zstd/blob/master/C/lizard/lizard_compress.c): `C/lizard/lizard_compress.c`
- [Fast LZMA2](https://github.com/mcmilk/7-zip-zstd/blob/master/C/fast-lzma2/lzma2_enc.c): `C/fast-lzma2/lzma2_enc.c`

### Security and hashes

- [Encryption methods](https://github.com/mcmilk/7-zip-zstd/tree/master/CPP/7zip/Crypto): `CPP/7zip/Crypto`
- [Hash algorithms](https://github.com/mcmilk/7-zip-zstd/tree/master/C/hashes): `C/hashes`

### Runtime support

- [Stream utilities](https://github.com/mcmilk/7-zip-zstd/blob/master/CPP/7zip/Common/FileStreams.cpp): `CPP/7zip/Common/FileStreams.cpp`
- [CPU and types](https://github.com/mcmilk/7-zip-zstd/blob/master/C/CpuArch.h): `C/CpuArch.h`
- [Core types](https://github.com/mcmilk/7-zip-zstd/blob/master/C/7zTypes.h): `C/7zTypes.h`

### Other components

- **User**

## Connections

- User → Command line: invokes
- User → File manager: uses
- User → Setup installer: installs
- Command line → Archive handlers: opens archives
- File manager → Archive handlers: browses archives
- SFX extractor → Archive handlers: opens archive (evidence: `CPP/7zip/Bundles/SFXSetup/ExtractEngine.cpp`)
- SFX extractor → Extraction callback: extracts through (evidence: `CPP/7zip/Bundles/SFXSetup/ExtractEngine.cpp`)
- Archive handlers → 7z format: supports
- Archive handlers → ZIP format: supports
- Archive handlers → TAR format: supports
- Archive handlers → Codec integration: uses codecs (evidence: `CPP/7zip/Archive/ApfsHandler.cpp`)
- Codec integration → Zstandard: registers
- Codec integration → Brotli: registers
- Codec integration → LZ4: registers
- Codec integration → Lizard: registers
- Codec integration → Fast LZMA2: registers
- Archive handlers → Encryption methods: supports encryption (evidence: `CPP/7zip/Archive/Rar/Rar5Handler.cpp`)
- Command line → Hash algorithms: offers hashers
- Archive handlers → Stream utilities: uses streams
- Zstandard → CPU and types: uses CPU support
- CPU and types → Core types: includes (evidence: `C/CpuArch.h`)
