# frankbarretta/losslessproxy architecture

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

- Interactive diagram: https://gitdiagram.com/frankbarretta/losslessproxy
- Repository: https://github.com/frankbarretta/losslessproxy

## Overview

LosslessProxy is a Windows DLL proxy that forwards Lossless Scaling calls while adding addon loading, shader interception, and a management overlay. The main runtime flow initializes the proxy and original engine, scans addons and configuration, installs hooks, then starts the GUI thread that loads addons. Addons can use the host API for configuration, events, logging, and D3D11/dispatch access. README-described export forwarding and security/dependency capabilities are included; links for unsampled implementation details rely on README documentation or are omitted where wiring is not evidenced.

Main entry points: [`LosslessProxy/src/addon/addon_manager.cpp`](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/addon/addon_manager.cpp) (Addon lifecycle), [`LosslessProxy/src/core/main.cpp`](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/core/main.cpp) (Proxy lifecycle), [`LosslessProxy/src/gui/gui_manager.cpp`](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/gui/gui_manager.cpp) (Overlay manager), [`LosslessProxy/src/host/host_impl.cpp`](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/host/host_impl.cpp) (Host interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_proxy["Proxy runtime"]
  node_proxy_core["Proxy lifecycle<br/>[main.cpp]"]
  node_original_engine["Original engine"]
  node_shader_hooks["Shader interception<br/>[shader_hook.cpp]"]
  node_d3d_hooks["D3D11 hooks<br/>[d3d11_hook.cpp]"]
end

subgraph group_addons["Addon platform"]
  node_addon_manager["Addon lifecycle<br/>[addon_manager.cpp]"]
  node_addon_records["Addon metadata<br/>[addon_info.h]"]
  node_dependencies["Dependency ordering"]
  node_security["Addon verification<br/>[addon_security.cpp]"]
  node_sdk_contract["Addon SDK<br/>[addon_exports.h]"]
end

subgraph group_services["Host services"]
  node_host_api["Host interface<br/>[host_impl.cpp]"]
  node_event_bus["Event bus<br/>[event_system.cpp]"]
  node_configuration[("Configuration<br/>[config_manager.cpp]")]
  node_logging[("Logging<br/>[logger.cpp]")]
end

subgraph group_overlay["Management overlay"]
  node_gui["Overlay manager<br/>[gui_manager.cpp]"]
  node_addon_tab["Addon controls<br/>[tab_addons.cpp]"]
  node_settings_tab["Settings view<br/>[tab_settings.cpp]"]
  node_logs_tab["Log view<br/>[tab_logs.cpp]"]
  node_about_tab["About view<br/>[tab_about.cpp]"]
end

node_scaling_app(("Lossless Scaling"))
node_addon_dlls["Addon DLLs"]

node_scaling_app -->|"loads proxy"| node_proxy_core
node_proxy_core -->|"loads engine"| node_original_engine
node_proxy_core -->|"creates and scans"| node_addon_manager
node_proxy_core -->|"installs hooks"| node_shader_hooks
node_proxy_core -->|"initializes hooks"| node_d3d_hooks
node_proxy_core -->|"starts thread"| node_gui
node_proxy_core -->|"publishes shutdown"| node_event_bus
node_proxy_core -->|"initializes logger"| node_logging
node_shader_hooks -->|"queries interceptors"| node_addon_manager
node_d3d_hooks -->|"sets device state"| node_host_api
node_d3d_hooks -->|"publishes events"| node_event_bus
node_addon_manager -->|"records metadata"| node_addon_records
node_addon_manager -->|"resolves ordering"| node_dependencies
node_addon_manager -->|"verifies DLLs"| node_security
node_addon_manager -->|"loads and saves"| node_configuration
node_addon_manager -->|"publishes lifecycle"| node_event_bus
node_addon_manager -->|"initializes addons"| node_host_api
node_addon_manager -->|"loads and invokes"| node_addon_dlls
node_addon_dlls -->|"implements exports"| node_sdk_contract
node_host_api -->|"serves config"| node_configuration
node_host_api -->|"dispatches events"| node_event_bus
node_host_api -->|"writes logs"| node_logging
node_gui -->|"loads addons"| node_addon_manager
node_gui -->|"renders tab"| node_addon_tab
node_gui -->|"renders tab"| node_settings_tab
node_gui -->|"renders tab"| node_logs_tab
node_gui -->|"renders tab"| node_about_tab
node_addon_tab -->|"manages addons"| node_addon_manager
node_settings_tab -->|"reads settings"| node_configuration
node_gui -->|"uses logger"| node_logging

click node_proxy_core "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/core/main.cpp"
click node_shader_hooks "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/core/shader_hook.cpp"
click node_d3d_hooks "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/core/d3d11_hook.cpp"
click node_addon_manager "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/addon/addon_manager.cpp"
click node_addon_records "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/addon/addon_info.h"
click node_dependencies "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/addon/addon_dependency.cpp"
click node_security "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/addon/addon_security.cpp"
click node_sdk_contract "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/sdk/include/lsproxy/addon_exports.h"
click node_host_api "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/host/host_impl.cpp"
click node_event_bus "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/event/event_system.cpp"
click node_configuration "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/config/config_manager.cpp"
click node_logging "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/log/logger.cpp"
click node_gui "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/gui/gui_manager.cpp"
click node_addon_tab "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/gui/tabs/tab_addons.cpp"
click node_settings_tab "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/gui/tabs/tab_settings.cpp"
click node_logs_tab "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/gui/tabs/tab_logs.cpp"
click node_about_tab "https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/gui/tabs/tab_about.cpp"

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_proxy_core,node_original_engine,node_shader_hooks,node_d3d_hooks toneBlue
class node_addon_manager,node_addon_records,node_dependencies,node_security,node_sdk_contract toneAmber
class node_host_api,node_event_bus,node_configuration,node_logging toneMint
class node_gui,node_addon_tab,node_settings_tab,node_logs_tab,node_about_tab toneRose
class node_scaling_app,node_addon_dlls toneIndigo
```

## Components

### Proxy runtime

- [Proxy lifecycle](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/core/main.cpp): `LosslessProxy/src/core/main.cpp`
- **Original engine**
- [Shader interception](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/core/shader_hook.cpp): `LosslessProxy/src/core/shader_hook.cpp`
- [D3D11 hooks](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/core/d3d11_hook.cpp): `LosslessProxy/src/core/d3d11_hook.cpp`

### Addon platform

- [Addon lifecycle](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/addon/addon_manager.cpp): `LosslessProxy/src/addon/addon_manager.cpp`
- [Addon metadata](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/addon/addon_info.h): `LosslessProxy/src/addon/addon_info.h`
- [Dependency ordering](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/addon/addon_dependency.cpp): `LosslessProxy/src/addon/addon_dependency.cpp`
- [Addon verification](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/addon/addon_security.cpp): `LosslessProxy/src/addon/addon_security.cpp`
- [Addon SDK](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/sdk/include/lsproxy/addon_exports.h): `LosslessProxy/sdk/include/lsproxy/addon_exports.h`

### Host services

- [Host interface](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/host/host_impl.cpp): `LosslessProxy/src/host/host_impl.cpp`
- [Event bus](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/event/event_system.cpp): `LosslessProxy/src/event/event_system.cpp`
- [Configuration](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/config/config_manager.cpp): `LosslessProxy/src/config/config_manager.cpp`
- [Logging](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/log/logger.cpp): `LosslessProxy/src/log/logger.cpp`

### Management overlay

- [Overlay manager](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/gui/gui_manager.cpp): `LosslessProxy/src/gui/gui_manager.cpp`
- [Addon controls](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/gui/tabs/tab_addons.cpp): `LosslessProxy/src/gui/tabs/tab_addons.cpp`
- [Settings view](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/gui/tabs/tab_settings.cpp): `LosslessProxy/src/gui/tabs/tab_settings.cpp`
- [Log view](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/gui/tabs/tab_logs.cpp): `LosslessProxy/src/gui/tabs/tab_logs.cpp`
- [About view](https://github.com/frankbarretta/losslessproxy/blob/main/LosslessProxy/src/gui/tabs/tab_about.cpp): `LosslessProxy/src/gui/tabs/tab_about.cpp`

### Other components

- **Lossless Scaling**
- **Addon DLLs**

## Connections

- Lossless Scaling → Proxy lifecycle: loads proxy
- Proxy lifecycle → Original engine: loads engine (evidence: `LosslessProxy/src/core/main.cpp`)
- Proxy lifecycle → Addon lifecycle: creates and scans (evidence: `LosslessProxy/src/core/main.cpp`)
- Proxy lifecycle → Shader interception: installs hooks (evidence: `LosslessProxy/src/core/main.cpp`)
- Proxy lifecycle → D3D11 hooks: initializes hooks (evidence: `LosslessProxy/src/core/main.cpp`)
- Proxy lifecycle → Overlay manager: starts thread (evidence: `LosslessProxy/src/core/main.cpp`)
- Proxy lifecycle → Event bus: publishes shutdown (evidence: `LosslessProxy/src/core/main.cpp`)
- Proxy lifecycle → Logging: initializes logger (evidence: `LosslessProxy/src/core/main.cpp`)
- Shader interception → Addon lifecycle: queries interceptors (evidence: `LosslessProxy/src/core/shader_hook.cpp`)
- D3D11 hooks → Host interface: sets device state (evidence: `LosslessProxy/src/core/d3d11_hook.cpp`)
- D3D11 hooks → Event bus: publishes events (evidence: `LosslessProxy/src/core/d3d11_hook.cpp`)
- Addon lifecycle → Addon metadata: records metadata (evidence: `LosslessProxy/src/addon/addon_manager.cpp`)
- Addon lifecycle → Dependency ordering: resolves ordering (evidence: `LosslessProxy/src/addon/addon_manager.cpp`)
- Addon lifecycle → Addon verification: verifies DLLs (evidence: `LosslessProxy/src/addon/addon_manager.cpp`)
- Addon lifecycle → Configuration: loads and saves (evidence: `LosslessProxy/src/addon/addon_manager.cpp`)
- Addon lifecycle → Event bus: publishes lifecycle (evidence: `LosslessProxy/src/addon/addon_manager.cpp`)
- Addon lifecycle → Host interface: initializes addons (evidence: `LosslessProxy/src/addon/addon_manager.cpp`)
- Addon lifecycle → Addon DLLs: loads and invokes
- Addon DLLs → Addon SDK: implements exports
- Host interface → Configuration: serves config (evidence: `LosslessProxy/src/host/host_impl.cpp`)
- Host interface → Event bus: dispatches events (evidence: `LosslessProxy/src/host/host_impl.cpp`)
- Host interface → Logging: writes logs (evidence: `LosslessProxy/src/host/host_impl.cpp`)
- Overlay manager → Addon lifecycle: loads addons (evidence: `LosslessProxy/src/gui/gui_manager.cpp`)
- Overlay manager → Addon controls: renders tab (evidence: `LosslessProxy/src/gui/gui_manager.cpp`)
- Overlay manager → Settings view: renders tab (evidence: `LosslessProxy/src/gui/gui_manager.cpp`)
- Overlay manager → Log view: renders tab (evidence: `LosslessProxy/src/gui/gui_manager.cpp`)
- Overlay manager → About view: renders tab (evidence: `LosslessProxy/src/gui/gui_manager.cpp`)
- Addon controls → Addon lifecycle: manages addons (evidence: `LosslessProxy/src/gui/tabs/tab_addons.cpp`)
- Settings view → Configuration: reads settings (evidence: `LosslessProxy/src/gui/tabs/tab_settings.cpp`)
- Overlay manager → Logging: uses logger (evidence: `LosslessProxy/src/gui/gui_manager.cpp`)
