# abrignoni/gleapp architecture

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

- Interactive diagram: https://gitdiagram.com/abrignoni/gleapp
- Repository: https://github.com/abrignoni/gleapp

## Overview

GLEAPP is a local digital-forensics media triage and review toolkit. Examiners ingest folders, extraction archives, or disk images; processing registers media, computes hashes and metadata, generates thumbnails/key frames, screens and matches files, then organizes duplicates for review in a case-backed gallery. Review decisions and case data feed exports and similarity search. The graph preserves documented archive, ExoPlayer-cache, known-hash, VIC, reporting, mapping, and recovery capabilities. Several subsystem links are documented in the README or SOURCE INDEX; unsampled internals are not treated as inspected.

Main entry points: [`gleapp/pipeline.py`](https://github.com/abrignoni/gleapp/blob/main/gleapp/pipeline.py) (Processing pipeline), [`gleapp/cli.py`](https://github.com/abrignoni/gleapp/blob/main/gleapp/cli.py) (CLI), [`gleapp/web/app.py`](https://github.com/abrignoni/gleapp/blob/main/gleapp/web/app.py) (Review gallery), [`gleapp/db.py`](https://github.com/abrignoni/gleapp/blob/main/gleapp/db.py) (Case database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Evidence intake"]
  node_ingest["Source discovery<br/>[ingest.py]"]
  node_acquire["Archives and images<br/>[archive.py]"]
  node_exocache["ExoPlayer recovery<br/>[exocache.py]"]
end

subgraph group_analysis["Media analysis"]
  node_pipeline["Processing pipeline<br/>[pipeline.py]"]
  node_hashing["File and visual hashes<br/>[hashing.py]"]
  node_metadata["Media metadata<br/>[metadata.py]"]
  node_imaging["Images and key frames<br/>[imaging.py]"]
  node_screening["Visual screening<br/>[detect.py]"]
  node_workers["Isolated video worker<br/>[_vidworker.py]"]
  node_matching["Known-hash matching<br/>[hashdb.py]"]
  node_dedupe["Duplicate grouping<br/>[dedupe.py]"]
  node_globalhashes[("Shared hash store<br/>[hashstore.py]")]
end

subgraph group_case["Case and review"]
  node_case["Case management<br/>[case.py]"]
  node_database[("Case database<br/>[db.py]")]
  node_vic["Project VIC<br/>[projectvic.py]"]
  node_review["Categories and flags<br/>[categories.py]"]
end

subgraph group_outputs["Search and exports"]
  node_simindex["Perceptual index<br/>[simindex.py]"]
  node_content["Content similarity<br/>[content.py]"]
  node_reports["Reports and exports<br/>[report.py]"]
  node_lava["LAVA export<br/>[lava.py]"]
  node_maps["Map exports<br/>[basemaps.py]"]
end

subgraph group_app["Application"]
  node_cli["CLI<br/>[cli.py]"]
  node_gallery["Review gallery<br/>[app.py]"]
end

node_examiner(("Examiner"))

node_examiner -->|"runs commands"| node_cli
node_examiner -->|"reviews media"| node_gallery
node_cli -->|"starts processing"| node_pipeline
node_pipeline -->|"discovers sources"| node_ingest
node_pipeline -->|"ingests acquisitions"| node_acquire
node_pipeline -->|"joins cache media"| node_exocache
node_pipeline -->|"computes hashes"| node_hashing
node_pipeline -->|"extracts metadata"| node_metadata
node_pipeline -->|"generates previews"| node_imaging
node_pipeline -->|"screens images"| node_screening
node_pipeline -->|"isolates video decode"| node_workers
node_pipeline -->|"matches known hashes"| node_matching
node_pipeline -->|"groups duplicates"| node_dedupe
node_pipeline -->|"persists processing"| node_database
node_gallery -->|"reads and updates"| node_database
node_case -->|"opens case store"| node_database
node_case -->|"supports acquisitions"| node_acquire
node_case -->|"imports VIC cases"| node_vic
node_gallery -->|"supports categorization"| node_review
node_matching -->|"uses shared store"| node_globalhashes
node_gallery -->|"finds visual copies"| node_simindex
node_gallery -->|"ranks content matches"| node_content
node_cli -->|"exports reports"| node_reports
node_cli -->|"exports LAVA"| node_lava
node_cli -->|"exports maps"| node_maps
node_reports -->|"reads case records"| node_database
node_lava -->|"reads case records"| node_database
node_examiner -->|"may recover deleted media"| node_acquire

click node_cli "https://github.com/abrignoni/gleapp/blob/main/gleapp/cli.py"
click node_gallery "https://github.com/abrignoni/gleapp/blob/main/gleapp/web/app.py"
click node_ingest "https://github.com/abrignoni/gleapp/blob/main/gleapp/ingest.py"
click node_acquire "https://github.com/abrignoni/gleapp/blob/main/gleapp/archive.py"
click node_exocache "https://github.com/abrignoni/gleapp/blob/main/gleapp/exocache.py"
click node_pipeline "https://github.com/abrignoni/gleapp/blob/main/gleapp/pipeline.py"
click node_hashing "https://github.com/abrignoni/gleapp/blob/main/gleapp/hashing.py"
click node_metadata "https://github.com/abrignoni/gleapp/blob/main/gleapp/metadata.py"
click node_imaging "https://github.com/abrignoni/gleapp/blob/main/gleapp/imaging.py"
click node_screening "https://github.com/abrignoni/gleapp/blob/main/gleapp/detect.py"
click node_workers "https://github.com/abrignoni/gleapp/blob/main/gleapp/_vidworker.py"
click node_matching "https://github.com/abrignoni/gleapp/blob/main/gleapp/hashdb.py"
click node_dedupe "https://github.com/abrignoni/gleapp/blob/main/gleapp/dedupe.py"
click node_simindex "https://github.com/abrignoni/gleapp/blob/main/gleapp/simindex.py"
click node_content "https://github.com/abrignoni/gleapp/blob/main/gleapp/content.py"
click node_case "https://github.com/abrignoni/gleapp/blob/main/gleapp/case.py"
click node_database "https://github.com/abrignoni/gleapp/blob/main/gleapp/db.py"
click node_vic "https://github.com/abrignoni/gleapp/blob/main/gleapp/projectvic.py"
click node_review "https://github.com/abrignoni/gleapp/blob/main/gleapp/categories.py"
click node_reports "https://github.com/abrignoni/gleapp/blob/main/gleapp/report.py"
click node_lava "https://github.com/abrignoni/gleapp/blob/main/gleapp/lava.py"
click node_maps "https://github.com/abrignoni/gleapp/blob/main/gleapp/basemaps.py"
click node_globalhashes "https://github.com/abrignoni/gleapp/blob/main/gleapp/hashstore.py"

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_ingest,node_acquire,node_exocache toneBlue
class node_pipeline,node_hashing,node_metadata,node_imaging,node_screening,node_workers,node_matching,node_dedupe,node_globalhashes toneAmber
class node_case,node_database,node_vic,node_review toneMint
class node_simindex,node_content,node_reports,node_lava,node_maps toneRose
class node_cli,node_gallery,node_examiner toneIndigo
```

## Components

### Evidence intake

- [Source discovery](https://github.com/abrignoni/gleapp/blob/main/gleapp/ingest.py): `gleapp/ingest.py`
- [Archives and images](https://github.com/abrignoni/gleapp/blob/main/gleapp/archive.py): `gleapp/archive.py`
- [ExoPlayer recovery](https://github.com/abrignoni/gleapp/blob/main/gleapp/exocache.py): `gleapp/exocache.py`

### Media analysis

- [Processing pipeline](https://github.com/abrignoni/gleapp/blob/main/gleapp/pipeline.py): `gleapp/pipeline.py`
- [File and visual hashes](https://github.com/abrignoni/gleapp/blob/main/gleapp/hashing.py): `gleapp/hashing.py`
- [Media metadata](https://github.com/abrignoni/gleapp/blob/main/gleapp/metadata.py): `gleapp/metadata.py`
- [Images and key frames](https://github.com/abrignoni/gleapp/blob/main/gleapp/imaging.py): `gleapp/imaging.py`
- [Visual screening](https://github.com/abrignoni/gleapp/blob/main/gleapp/detect.py): `gleapp/detect.py`
- [Isolated video worker](https://github.com/abrignoni/gleapp/blob/main/gleapp/_vidworker.py): `gleapp/_vidworker.py`
- [Known-hash matching](https://github.com/abrignoni/gleapp/blob/main/gleapp/hashdb.py): `gleapp/hashdb.py`
- [Duplicate grouping](https://github.com/abrignoni/gleapp/blob/main/gleapp/dedupe.py): `gleapp/dedupe.py`
- [Shared hash store](https://github.com/abrignoni/gleapp/blob/main/gleapp/hashstore.py): `gleapp/hashstore.py`

### Case and review

- [Case management](https://github.com/abrignoni/gleapp/blob/main/gleapp/case.py): `gleapp/case.py`
- [Case database](https://github.com/abrignoni/gleapp/blob/main/gleapp/db.py): `gleapp/db.py`
- [Project VIC](https://github.com/abrignoni/gleapp/blob/main/gleapp/projectvic.py): `gleapp/projectvic.py`
- [Categories and flags](https://github.com/abrignoni/gleapp/blob/main/gleapp/categories.py): `gleapp/categories.py`

### Search and exports

- [Perceptual index](https://github.com/abrignoni/gleapp/blob/main/gleapp/simindex.py): `gleapp/simindex.py`
- [Content similarity](https://github.com/abrignoni/gleapp/blob/main/gleapp/content.py): `gleapp/content.py`
- [Reports and exports](https://github.com/abrignoni/gleapp/blob/main/gleapp/report.py): `gleapp/report.py`
- [LAVA export](https://github.com/abrignoni/gleapp/blob/main/gleapp/lava.py): `gleapp/lava.py`
- [Map exports](https://github.com/abrignoni/gleapp/blob/main/gleapp/basemaps.py): `gleapp/basemaps.py`

### Application

- [CLI](https://github.com/abrignoni/gleapp/blob/main/gleapp/cli.py): `gleapp/cli.py`
- [Review gallery](https://github.com/abrignoni/gleapp/blob/main/gleapp/web/app.py): `gleapp/web/app.py`

### Other components

- **Examiner**

## Connections

- Examiner → CLI: runs commands
- Examiner → Review gallery: reviews media
- CLI → Processing pipeline: starts processing (evidence: `gleapp/cli.py`)
- Processing pipeline → Source discovery: discovers sources (evidence: `gleapp/pipeline.py`)
- Processing pipeline → Archives and images: ingests acquisitions (evidence: `gleapp/pipeline.py`)
- Processing pipeline → ExoPlayer recovery: joins cache media (evidence: `gleapp/pipeline.py`)
- Processing pipeline → File and visual hashes: computes hashes (evidence: `gleapp/pipeline.py`)
- Processing pipeline → Media metadata: extracts metadata (evidence: `gleapp/pipeline.py`)
- Processing pipeline → Images and key frames: generates previews (evidence: `gleapp/pipeline.py`)
- Processing pipeline → Visual screening: screens images (evidence: `gleapp/pipeline.py`)
- Processing pipeline → Isolated video worker: isolates video decode (evidence: `gleapp/_vidworker.py`)
- Processing pipeline → Known-hash matching: matches known hashes (evidence: `gleapp/pipeline.py`)
- Processing pipeline → Duplicate grouping: groups duplicates (evidence: `gleapp/pipeline.py`)
- Processing pipeline → Case database: persists processing (evidence: `gleapp/db.py`)
- Review gallery → Case database: reads and updates (evidence: `gleapp/db.py`)
- Case management → Case database: opens case store (evidence: `gleapp/case.py`)
- Case management → Archives and images: supports acquisitions (evidence: `gleapp/case.py`)
- Case management → Project VIC: imports VIC cases (evidence: `gleapp/case.py`)
- Review gallery → Categories and flags: supports categorization (evidence: `gleapp/web/app.py`)
- Known-hash matching → Shared hash store: uses shared store (evidence: `gleapp/hashdb.py`)
- Review gallery → Perceptual index: finds visual copies (evidence: `gleapp/web/app.py`)
- Review gallery → Content similarity: ranks content matches (evidence: `gleapp/web/app.py`)
- CLI → Reports and exports: exports reports (evidence: `gleapp/cli.py`)
- CLI → LAVA export: exports LAVA (evidence: `gleapp/cli.py`)
- CLI → Map exports: exports maps (evidence: `gleapp/cli.py`)
- Reports and exports → Case database: reads case records (evidence: `gleapp/lava.py`)
- LAVA export → Case database: reads case records (evidence: `gleapp/lava.py`)
- Examiner → Archives and images: may recover deleted media
