# exeqtr-red/gleb-viewer architecture

> Architecture diagram of the GitHub repository exeqtr-red/gleb-viewer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/exeqtr-red/gleb-viewer
- Repository: https://github.com/exeqtr-red/gleb-viewer

## Overview

GLEB Viewer is a desktop 3D asset browser: users choose a model directory, find a model in the searchable/tag-filtered tree, and load it into the embedded F3D viewer. The main window also coordinates previews, reference galleries, category-based HDRI selection, and batch screenshots. Settings and visual preferences are separate supporting capabilities. Relationships are grounded in the excerpts and README; unsampled implementation details are represented only where documented.

Main entry points: [`src/main_window.py`](https://github.com/exeqtr-red/gleb-viewer/blob/main/src/main_window.py) (Main window), [`src/f3d_widget.py`](https://github.com/exeqtr-red/gleb-viewer/blob/main/src/f3d_widget.py) (F3D viewer), [`src/model_tree.py`](https://github.com/exeqtr-red/gleb-viewer/blob/main/src/model_tree.py) (Model tree), [`src/settings_dialog.py`](https://github.com/exeqtr-red/gleb-viewer/blob/main/src/settings_dialog.py) (F3D settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop UI"]
  node_main["Main window<br/>[main_window.py]"]
  node_previews["Preview gallery<br/>[main_window.py]"]
  node_batch["Batch screenshots<br/>[main_window.py]"]
end

subgraph group_assets["Model browsing"]
  node_tree["Model tree<br/>[model_tree.py]"]
  node_tags[("Tag storage<br/>[tags.json]")]
  node_models["Model directory"]
end

subgraph group_render["3D rendering"]
  node_viewer["F3D viewer<br/>[f3d_widget.py]"]
  node_f3d["F3D engine"]
  node_hdri["HDRI maps"]
end

subgraph group_prefs["Settings and resources"]
  node_settings["F3D settings<br/>[settings_dialog.py]"]
  node_presets["Settings presets"]
  node_themes["Themes"]
  node_state[("Saved preferences<br/>[main_window.py]")]
end

node_user(("User"))

node_user -->|"uses"| node_main
node_main -->|"creates"| node_tree
node_main -->|"creates"| node_viewer
node_user -->|"chooses"| node_models
node_tree -->|"scans"| node_models
node_tree -->|"reads/writes"| node_tags
node_user -->|"selects model"| node_tree
node_main -->|"loads model"| node_viewer
node_main -->|"selects map"| node_hdri
node_main -->|"sets HDRI"| node_viewer
node_viewer -->|"renders with"| node_f3d
node_main -->|"shows"| node_previews
node_user -->|"opens gallery"| node_previews
node_main -->|"runs"| node_batch
node_batch -->|"gets model paths"| node_tree
node_batch -->|"renders screenshots"| node_viewer
node_main -->|"opens"| node_settings
node_settings -->|"applies options"| node_viewer
node_settings -->|"loads/saves"| node_presets
node_main -->|"loads theme"| node_themes
node_main -->|"persists preferences"| node_state

click node_main "https://github.com/exeqtr-red/gleb-viewer/blob/main/src/main_window.py"
click node_tree "https://github.com/exeqtr-red/gleb-viewer/blob/main/src/model_tree.py"
click node_tags "https://github.com/exeqtr-red/gleb-viewer/blob/main/tags.json"
click node_previews "https://github.com/exeqtr-red/gleb-viewer/blob/main/src/main_window.py"
click node_batch "https://github.com/exeqtr-red/gleb-viewer/blob/main/src/main_window.py"
click node_viewer "https://github.com/exeqtr-red/gleb-viewer/blob/main/src/f3d_widget.py"
click node_hdri "https://github.com/exeqtr-red/gleb-viewer/tree/main/hdri"
click node_settings "https://github.com/exeqtr-red/gleb-viewer/blob/main/src/settings_dialog.py"
click node_presets "https://github.com/exeqtr-red/gleb-viewer/tree/main/configs"
click node_themes "https://github.com/exeqtr-red/gleb-viewer/tree/main/themes"
click node_state "https://github.com/exeqtr-red/gleb-viewer/blob/main/src/main_window.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_main,node_previews,node_batch,node_user toneBlue
class node_tree,node_tags,node_models toneAmber
class node_viewer,node_f3d,node_hdri toneMint
class node_settings,node_presets,node_themes,node_state toneRose
```

## Components

### Desktop UI

- [Main window](https://github.com/exeqtr-red/gleb-viewer/blob/main/src/main_window.py): `src/main_window.py`
- [Preview gallery](https://github.com/exeqtr-red/gleb-viewer/blob/main/src/main_window.py): `src/main_window.py`
- [Batch screenshots](https://github.com/exeqtr-red/gleb-viewer/blob/main/src/main_window.py): `src/main_window.py`

### Model browsing

- [Model tree](https://github.com/exeqtr-red/gleb-viewer/blob/main/src/model_tree.py): `src/model_tree.py`
- [Tag storage](https://github.com/exeqtr-red/gleb-viewer/blob/main/tags.json): `tags.json`
- **Model directory**

### 3D rendering

- [F3D viewer](https://github.com/exeqtr-red/gleb-viewer/blob/main/src/f3d_widget.py): `src/f3d_widget.py`
- **F3D engine**
- [HDRI maps](https://github.com/exeqtr-red/gleb-viewer/tree/main/hdri): `hdri`

### Settings and resources

- [F3D settings](https://github.com/exeqtr-red/gleb-viewer/blob/main/src/settings_dialog.py): `src/settings_dialog.py`
- [Settings presets](https://github.com/exeqtr-red/gleb-viewer/tree/main/configs): `configs`
- [Themes](https://github.com/exeqtr-red/gleb-viewer/tree/main/themes): `themes`
- [Saved preferences](https://github.com/exeqtr-red/gleb-viewer/blob/main/src/main_window.py): `src/main_window.py`

### Other components

- **User**

## Connections

- User → Main window: uses (evidence: `README.md`)
- Main window → Model tree: creates (evidence: `src/main_window.py`)
- Main window → F3D viewer: creates (evidence: `src/main_window.py`)
- User → Model directory: chooses (evidence: `README.md`)
- Model tree → Model directory: scans (evidence: `README.md`)
- Model tree → Tag storage: reads/writes (evidence: `src/model_tree.py`)
- User → Model tree: selects model (evidence: `README.md`)
- Main window → F3D viewer: loads model (evidence: `README.md`)
- Main window → HDRI maps: selects map (evidence: `src/main_window.py`)
- Main window → F3D viewer: sets HDRI (evidence: `src/main_window.py`)
- F3D viewer → F3D engine: renders with (evidence: `src/f3d_widget.py`)
- Main window → Preview gallery: shows (evidence: `README.md`)
- User → Preview gallery: opens gallery (evidence: `README.md`)
- Main window → Batch screenshots: runs (evidence: `src/main_window.py`)
- Batch screenshots → Model tree: gets model paths (evidence: `src/main_window.py`)
- Batch screenshots → F3D viewer: renders screenshots (evidence: `README.md`)
- Main window → F3D settings: opens (evidence: `README.md`)
- F3D settings → F3D viewer: applies options (evidence: `src/settings_dialog.py`)
- F3D settings → Settings presets: loads/saves (evidence: `README.md`)
- Main window → Themes: loads theme (evidence: `src/main_window.py`)
- Main window → Saved preferences: persists preferences (evidence: `README.md`)
