# waywallen/open-wallpaper-engine architecture

> Architecture diagram of the GitHub repository waywallen/open-wallpaper-engine, 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/waywallen/open-wallpaper-engine
- Repository: https://github.com/waywallen/open-wallpaper-engine

## Overview

Open Wallpaper Engine provides two wallpaper runtimes: a Vulkan scene renderer for packaged scenes and a CEF-based renderer for web wallpapers. The scene workflow loads package assets, parses scene content into runtime objects, and prepares and renders frames; standalone and Waywallen hosts provide entry points. The README documents these product capabilities and host relationships. Source excerpts expose render-pipeline preparation and selected web and bridge behavior, but many parser and host connections are not shown, so those edges are omitted rather than inferred.

Main entry points: [`viewer/WebViewer/WebViewer.cpp`](https://github.com/waywallen/open-wallpaper-engine/blob/main/viewer/WebViewer/WebViewer.cpp) (WebViewer), [`src/Scene/SceneRenderPipeline.cpp`](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/SceneRenderPipeline.cpp) (Render preparation), [`src/Web/BrowserHost.cpp`](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Web/BrowserHost.cpp) (CEF browser host), [`src/Scene/Scene/Scene.cpp`](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Scene/Scene.cpp) (Scene state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Scene Content"]
  node_scene_parser["Scene parsing"]
  node_image_parser["Image layers"]
  node_texture_parser["Texture assets<br/>[TexImageParser.cpp]"]
  node_particle_parser["Particles<br/>[ParticleParser.cpp]"]
  node_particle_objects["Particle objects"]
  node_puppet_parser["Puppet models<br/>[MdlParser.cpp]"]
  node_text_parser["Text layers"]
  node_shader_parser["Shader parsing<br/>[ShaderParser.cpp]"]
  node_uniforms["Uniform sources<br/>[UniformSource.cpp]"]
  node_audio["Audio response"]
end

subgraph group_runtime["Scene Runtime"]
  node_scene["Scene state<br/>[Scene.cpp]"]
  node_text["Text runtime<br/>[Text.cpp]"]
  node_pipeline["Render preparation"]
  node_render_state["Render graph state"]
  node_vulkan["Vulkan renderer<br/>[VulkanRender.cpp]"]
end

subgraph group_web["Web Runtime"]
  node_web_host["CEF browser host<br/>[BrowserHost.cpp]"]
  node_web_client["Browser client<br/>[ClientHandler.cpp]"]
  node_web_paint["Offscreen painting"]
  node_web_app["Web application<br/>[AppHandler.cpp]"]
end

subgraph group_hosts["Viewer Hosts"]
  node_web_viewer["WebViewer<br/>[WebViewer.cpp]"]
  node_web_presenter["Web presentation<br/>[EglPresenter.cpp]"]
  node_web_blitter["Vulkan blitter<br/>[VulkanBlitter.cpp]"]
  node_scene_viewer["SceneViewer<br/>[SceneViewer.cpp]"]
  node_way_scene["Waywallen scene host<br/>[scene_entry.cpp]"]
  node_bridge_session["Bridge session<br/>[BridgeSession.cpp]"]
  node_way_web["Waywallen web host<br/>[web_entry.cpp]"]
  node_web_producer["Web producer device"]
end

node_user(("Wallpaper user"))
node_scene_pkg["Scene package"]

node_user -->|"runs viewer"| node_scene_viewer
node_scene_viewer -->|"loads package"| node_scene_pkg
node_user -->|"runs viewer"| node_web_viewer
node_web_viewer -.->|"hosts CEF"| node_web_host
node_web_host -.->|"uses client"| node_web_client
node_web_client -->|"sets render handler"| node_web_paint
node_web_app -.->|"configures browser"| node_web_host
node_web_viewer -.->|"presents frames"| node_web_presenter
node_web_viewer -.->|"blits frames"| node_web_blitter
node_user -->|"uses plugin"| node_way_scene
node_way_scene -.->|"uses bridge"| node_bridge_session
node_user -->|"uses plugin"| node_way_web
node_way_web -.->|"produces frames"| node_web_producer
node_scene_pkg -.->|"parses content"| node_scene_parser
node_scene -->|"prepares frames"| node_pipeline
node_pipeline -->|"captures changes"| node_scene
node_pipeline -->|"builds graph state"| node_render_state

click node_scene_parser "https://github.com/waywallen/open-wallpaper-engine/tree/main/src/Scene/Pkg/Parse/Scene"
click node_image_parser "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Image/SceneImageObjectParser.cpp"
click node_texture_parser "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Image/TexImageParser.cpp"
click node_particle_parser "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Particle/ParticleParser.cpp"
click node_particle_objects "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Particle/SceneParticleObjectParser.cpp"
click node_puppet_parser "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Puppet/MdlParser.cpp"
click node_text_parser "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Scene/SceneTextObjectParser.cpp"
click node_shader_parser "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Shader/ShaderParser.cpp"
click node_uniforms "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Uniform/UniformSource.cpp"
click node_audio "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Audio/SceneAudioResponse.cpp"
click node_scene "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Scene/Scene.cpp"
click node_text "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Text/Text.cpp"
click node_pipeline "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/SceneRenderPipeline.cpp"
click node_render_state "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/VulkanRender/BuildSceneRenderState.cpp"
click node_vulkan "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/VulkanRender/VulkanRender.cpp"
click node_web_host "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Web/BrowserHost.cpp"
click node_web_client "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Web/ClientHandler.cpp"
click node_web_paint "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Web/OsrRenderHandler.cpp"
click node_web_app "https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Web/AppHandler.cpp"
click node_web_viewer "https://github.com/waywallen/open-wallpaper-engine/blob/main/viewer/WebViewer/WebViewer.cpp"
click node_web_presenter "https://github.com/waywallen/open-wallpaper-engine/blob/main/viewer/WebViewer/EglPresenter.cpp"
click node_web_blitter "https://github.com/waywallen/open-wallpaper-engine/blob/main/viewer/WebViewer/VulkanBlitter.cpp"
click node_scene_viewer "https://github.com/waywallen/open-wallpaper-engine/blob/main/viewer/SceneViewer/SceneViewer.cpp"
click node_way_scene "https://github.com/waywallen/open-wallpaper-engine/blob/main/waywallen/SceneRenderer/scene_entry.cpp"
click node_bridge_session "https://github.com/waywallen/open-wallpaper-engine/blob/main/waywallen/Producer/BridgeSession.cpp"
click node_way_web "https://github.com/waywallen/open-wallpaper-engine/blob/main/waywallen/WebRenderer/web_entry.cpp"
click node_web_producer "https://github.com/waywallen/open-wallpaper-engine/blob/main/waywallen/WebRenderer/WebProducerDevice.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_scene_parser,node_image_parser,node_texture_parser,node_particle_parser,node_particle_objects,node_puppet_parser,node_text_parser,node_shader_parser,node_uniforms,node_audio,node_user toneBlue
class node_scene,node_text,node_pipeline,node_render_state,node_vulkan toneAmber
class node_web_host,node_web_client,node_web_paint,node_web_app toneMint
class node_web_viewer,node_web_presenter,node_web_blitter,node_scene_viewer,node_way_scene,node_bridge_session,node_way_web,node_web_producer toneRose
class node_scene_pkg toneIndigo
```

## Components

### Scene Content

- [Scene parsing](https://github.com/waywallen/open-wallpaper-engine/tree/main/src/Scene/Pkg/Parse/Scene): `src/Scene/Pkg/Parse/Scene`
- [Image layers](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Image/SceneImageObjectParser.cpp): `src/Scene/Pkg/Parse/Image/SceneImageObjectParser.cpp`
- [Texture assets](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Image/TexImageParser.cpp): `src/Scene/Pkg/Parse/Image/TexImageParser.cpp`
- [Particles](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Particle/ParticleParser.cpp): `src/Scene/Pkg/Parse/Particle/ParticleParser.cpp`
- [Particle objects](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Particle/SceneParticleObjectParser.cpp): `src/Scene/Pkg/Parse/Particle/SceneParticleObjectParser.cpp`
- [Puppet models](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Puppet/MdlParser.cpp): `src/Scene/Pkg/Parse/Puppet/MdlParser.cpp`
- [Text layers](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Scene/SceneTextObjectParser.cpp): `src/Scene/Pkg/Parse/Scene/SceneTextObjectParser.cpp`
- [Shader parsing](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Shader/ShaderParser.cpp): `src/Scene/Pkg/Parse/Shader/ShaderParser.cpp`
- [Uniform sources](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Pkg/Parse/Uniform/UniformSource.cpp): `src/Scene/Pkg/Parse/Uniform/UniformSource.cpp`
- [Audio response](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Audio/SceneAudioResponse.cpp): `src/Scene/Audio/SceneAudioResponse.cpp`

### Scene Runtime

- [Scene state](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Scene/Scene.cpp): `src/Scene/Scene/Scene.cpp`
- [Text runtime](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/Text/Text.cpp): `src/Scene/Text/Text.cpp`
- [Render preparation](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/SceneRenderPipeline.cpp): `src/Scene/SceneRenderPipeline.cpp`
- [Render graph state](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/VulkanRender/BuildSceneRenderState.cpp): `src/Scene/VulkanRender/BuildSceneRenderState.cpp`
- [Vulkan renderer](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Scene/VulkanRender/VulkanRender.cpp): `src/Scene/VulkanRender/VulkanRender.cpp`

### Web Runtime

- [CEF browser host](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Web/BrowserHost.cpp): `src/Web/BrowserHost.cpp`
- [Browser client](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Web/ClientHandler.cpp): `src/Web/ClientHandler.cpp`
- [Offscreen painting](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Web/OsrRenderHandler.cpp): `src/Web/OsrRenderHandler.cpp`
- [Web application](https://github.com/waywallen/open-wallpaper-engine/blob/main/src/Web/AppHandler.cpp): `src/Web/AppHandler.cpp`

### Viewer Hosts

- [WebViewer](https://github.com/waywallen/open-wallpaper-engine/blob/main/viewer/WebViewer/WebViewer.cpp): `viewer/WebViewer/WebViewer.cpp`
- [Web presentation](https://github.com/waywallen/open-wallpaper-engine/blob/main/viewer/WebViewer/EglPresenter.cpp): `viewer/WebViewer/EglPresenter.cpp`
- [Vulkan blitter](https://github.com/waywallen/open-wallpaper-engine/blob/main/viewer/WebViewer/VulkanBlitter.cpp): `viewer/WebViewer/VulkanBlitter.cpp`
- [SceneViewer](https://github.com/waywallen/open-wallpaper-engine/blob/main/viewer/SceneViewer/SceneViewer.cpp): `viewer/SceneViewer/SceneViewer.cpp`
- [Waywallen scene host](https://github.com/waywallen/open-wallpaper-engine/blob/main/waywallen/SceneRenderer/scene_entry.cpp): `waywallen/SceneRenderer/scene_entry.cpp`
- [Bridge session](https://github.com/waywallen/open-wallpaper-engine/blob/main/waywallen/Producer/BridgeSession.cpp): `waywallen/Producer/BridgeSession.cpp`
- [Waywallen web host](https://github.com/waywallen/open-wallpaper-engine/blob/main/waywallen/WebRenderer/web_entry.cpp): `waywallen/WebRenderer/web_entry.cpp`
- [Web producer device](https://github.com/waywallen/open-wallpaper-engine/blob/main/waywallen/WebRenderer/WebProducerDevice.cpp): `waywallen/WebRenderer/WebProducerDevice.cpp`

### Other components

- **Wallpaper user**
- **Scene package**

## Connections

- Wallpaper user → SceneViewer: runs viewer (evidence: `README.md`)
- SceneViewer → Scene package: loads package (evidence: `README.md`)
- Wallpaper user → WebViewer: runs viewer (evidence: `README.md`)
- WebViewer → CEF browser host: hosts CEF
- CEF browser host → Browser client: uses client
- Browser client → Offscreen painting: sets render handler (evidence: `src/Web/ClientHandler.cpp`)
- Web application → CEF browser host: configures browser
- WebViewer → Web presentation: presents frames
- WebViewer → Vulkan blitter: blits frames
- Wallpaper user → Waywallen scene host: uses plugin (evidence: `README.md`)
- Waywallen scene host → Bridge session: uses bridge
- Wallpaper user → Waywallen web host: uses plugin (evidence: `README.md`)
- Waywallen web host → Web producer device: produces frames
- Scene package → Scene parsing: parses content
- Scene state → Render preparation: prepares frames (evidence: `src/Scene/SceneRenderPipeline.cpp`)
- Render preparation → Scene state: captures changes (evidence: `src/Scene/SceneRenderPipeline.cpp`)
- Render preparation → Render graph state: builds graph state (evidence: `src/Scene/SceneRenderPipeline.cpp`)
