# ertugrulmutlu/openanima architecture

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

- Interactive diagram: https://gitdiagram.com/ertugrulmutlu/openanima
- Repository: https://github.com/ertugrulmutlu/openanima

## Overview

OpenAnima is a Windows desktop overlay engine. The main workflow is: a user imports local assets through the Library, configures detected metadata, adds an asset as an independent overlay, and controls its playback and behavior from the Desktop inspector. The graph also includes session persistence, recovery, and optional local automation. README claims supply several product-level capabilities; source excerpts establish the specific calls shown. Unsampled asset implementation files are not represented because they are absent from the supplied tree.

Main entry points: [`openanima_app/overlay/window.py`](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/overlay/window.py) (Overlay window), [`openanima_app/app.py`](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/app.py) (Application startup), [`openanima_app/ui/control_panel/panel.py`](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/ui/control_panel/panel.py) (Control panel), [`openanima_app/local_api.py`](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/local_api.py) (Local API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop experience"]
  node_app["Application startup<br/>[app.py]"]
  node_panel["Control panel<br/>[panel.py]"]
  node_desktop_page["Overlay inspector<br/>[desktop_page.py]"]
  node_editor["Overlay editor<br/>[editor_page.py]"]
end

subgraph group_assets["Asset preparation"]
  node_library["Asset library<br/>[library_page.py]"]
  node_imports["Import workflows"]
  node_setup["Asset setup<br/>[dialog.py]"]
  node_composite["Composite canvas"]
end

subgraph group_overlay["Overlay runtime"]
  node_overlay["Overlay window<br/>[window.py]"]
  node_renderers["Asset renderers"]
  node_apng["APNG playback<br/>[apng_player.py]"]
  node_frames["Frame playback<br/>[frame_player.py]"]
  node_video["Video playback<br/>[video_renderer.py]"]
  node_movement["Movement physics<br/>[movement.py]"]
end

subgraph group_runtime["Runtime services"]
  node_actions["Overlay actions<br/>[action_runner.py]"]
  node_api["Local API<br/>[local_api.py]"]
  node_session["Session persistence<br/>[session.py]"]
  node_config[("Local configuration<br/>[config.py]")]
  node_recovery["Recovery tools<br/>[recovery.py]"]
  node_logging["Diagnostics logging<br/>[logging.py]"]
end

node_user(("Desktop user"))
node_automation(("Local automation"))

node_user -->|"launches"| node_app
node_app -->|"creates"| node_panel
node_panel -->|"presents"| node_library
node_user -->|"selects assets"| node_library
node_library -->|"starts import"| node_imports
node_imports -->|"opens setup"| node_setup
node_setup -->|"renders canvas"| node_composite
node_user -->|"confirms metadata"| node_setup
node_panel -->|"presents"| node_desktop_page
node_desktop_page -->|"controls overlays"| node_overlay
node_panel -->|"delegates editing"| node_editor
node_editor -->|"configures movement"| node_movement
node_overlay -->|"renders metadata assets"| node_renderers
node_overlay -->|"uses playback"| node_apng
node_overlay -->|"uses playback"| node_frames
node_overlay -->|"uses playback"| node_video
node_overlay -->|"runs action"| node_actions
node_app -->|"restores session"| node_session
node_session -->|"loads and saves"| node_config
node_session -->|"restores state"| node_overlay
node_panel -->|"offers recovery"| node_recovery
node_app -->|"provides tray recovery"| node_recovery
node_recovery -->|"persists changes"| node_session
node_app -->|"starts optionally"| node_api
node_automation -->|"sends commands"| node_api
node_api -->|"updates overlays"| node_overlay
node_api -->|"persists changes"| node_session
node_api -->|"refreshes view"| node_panel
node_app -->|"configures logging"| node_logging
node_recovery -->|"records actions"| node_logging

click node_app "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/app.py"
click node_panel "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/ui/control_panel/panel.py"
click node_library "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/ui/control_panel/library_page.py"
click node_imports "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/ui/control_panel/import_workflows.py"
click node_setup "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/ui/asset_setup/dialog.py"
click node_composite "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/ui/asset_setup/composite_canvas.py"
click node_desktop_page "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/ui/control_panel/desktop_page.py"
click node_editor "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/ui/control_panel/editor_page.py"
click node_overlay "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/overlay/window.py"
click node_renderers "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/rendering/metadata_renderers.py"
click node_apng "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/rendering/apng_player.py"
click node_frames "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/rendering/frame_player.py"
click node_video "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/rendering/video_renderer.py"
click node_movement "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/overlay/movement.py"
click node_actions "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/runtime/action_runner.py"
click node_api "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/local_api.py"
click node_session "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/runtime/session.py"
click node_config "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/runtime/config.py"
click node_recovery "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/runtime/recovery.py"
click node_logging "https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/runtime/logging.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_app,node_panel,node_desktop_page,node_editor,node_user toneBlue
class node_library,node_imports,node_setup,node_composite toneAmber
class node_overlay,node_renderers,node_apng,node_frames,node_video,node_movement toneMint
class node_actions,node_api,node_session,node_config,node_recovery,node_logging toneRose
class node_automation toneIndigo
```

## Components

### Desktop experience

- [Application startup](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/app.py): `openanima_app/app.py`
- [Control panel](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/ui/control_panel/panel.py): `openanima_app/ui/control_panel/panel.py`
- [Overlay inspector](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/ui/control_panel/desktop_page.py): `openanima_app/ui/control_panel/desktop_page.py`
- [Overlay editor](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/ui/control_panel/editor_page.py): `openanima_app/ui/control_panel/editor_page.py`

### Asset preparation

- [Asset library](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/ui/control_panel/library_page.py): `openanima_app/ui/control_panel/library_page.py`
- [Import workflows](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/ui/control_panel/import_workflows.py): `openanima_app/ui/control_panel/import_workflows.py`
- [Asset setup](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/ui/asset_setup/dialog.py): `openanima_app/ui/asset_setup/dialog.py`
- [Composite canvas](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/ui/asset_setup/composite_canvas.py): `openanima_app/ui/asset_setup/composite_canvas.py`

### Overlay runtime

- [Overlay window](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/overlay/window.py): `openanima_app/overlay/window.py`
- [Asset renderers](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/rendering/metadata_renderers.py): `openanima_app/rendering/metadata_renderers.py`
- [APNG playback](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/rendering/apng_player.py): `openanima_app/rendering/apng_player.py`
- [Frame playback](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/rendering/frame_player.py): `openanima_app/rendering/frame_player.py`
- [Video playback](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/rendering/video_renderer.py): `openanima_app/rendering/video_renderer.py`
- [Movement physics](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/overlay/movement.py): `openanima_app/overlay/movement.py`

### Runtime services

- [Overlay actions](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/runtime/action_runner.py): `openanima_app/runtime/action_runner.py`
- [Local API](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/local_api.py): `openanima_app/local_api.py`
- [Session persistence](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/runtime/session.py): `openanima_app/runtime/session.py`
- [Local configuration](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/runtime/config.py): `openanima_app/runtime/config.py`
- [Recovery tools](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/runtime/recovery.py): `openanima_app/runtime/recovery.py`
- [Diagnostics logging](https://github.com/ertugrulmutlu/openanima/blob/main/openanima_app/runtime/logging.py): `openanima_app/runtime/logging.py`

### Other components

- **Desktop user**
- **Local automation**

## Connections

- Desktop user → Application startup: launches (evidence: `README.md`)
- Application startup → Control panel: creates (evidence: `openanima_app/app.py`)
- Control panel → Asset library: presents (evidence: `openanima_app/ui/control_panel/panel.py`)
- Desktop user → Asset library: selects assets (evidence: `README.md`)
- Asset library → Import workflows: starts import (evidence: `openanima_app/ui/control_panel/library_page.py`)
- Import workflows → Asset setup: opens setup (evidence: `openanima_app/ui/control_panel/import_workflows.py`)
- Asset setup → Composite canvas: renders canvas (evidence: `openanima_app/ui/asset_setup/dialog.py`)
- Desktop user → Asset setup: confirms metadata (evidence: `README.md`)
- Control panel → Overlay inspector: presents (evidence: `openanima_app/ui/control_panel/panel.py`)
- Overlay inspector → Overlay window: controls overlays (evidence: `openanima_app/ui/control_panel/desktop_page.py`)
- Control panel → Overlay editor: delegates editing (evidence: `openanima_app/ui/control_panel/panel.py`)
- Overlay editor → Movement physics: configures movement (evidence: `openanima_app/ui/control_panel/editor_page.py`)
- Overlay window → Asset renderers: renders metadata assets (evidence: `openanima_app/overlay/window.py`)
- Overlay window → APNG playback: uses playback (evidence: `openanima_app/overlay/window.py`)
- Overlay window → Frame playback: uses playback (evidence: `openanima_app/overlay/window.py`)
- Overlay window → Video playback: uses playback (evidence: `openanima_app/overlay/window.py`)
- Overlay window → Overlay actions: runs action (evidence: `openanima_app/overlay/window.py`)
- Application startup → Session persistence: restores session (evidence: `openanima_app/app.py`)
- Session persistence → Local configuration: loads and saves (evidence: `openanima_app/runtime/session.py`)
- Session persistence → Overlay window: restores state (evidence: `openanima_app/runtime/session.py`)
- Control panel → Recovery tools: offers recovery (evidence: `openanima_app/ui/control_panel/panel.py`)
- Application startup → Recovery tools: provides tray recovery (evidence: `openanima_app/app.py`)
- Recovery tools → Session persistence: persists changes (evidence: `openanima_app/runtime/recovery.py`)
- Application startup → Local API: starts optionally (evidence: `openanima_app/app.py`)
- Local automation → Local API: sends commands (evidence: `README.md`)
- Local API → Overlay window: updates overlays (evidence: `openanima_app/local_api.py`)
- Local API → Session persistence: persists changes (evidence: `openanima_app/local_api.py`)
- Local API → Control panel: refreshes view (evidence: `openanima_app/local_api.py`)
- Application startup → Diagnostics logging: configures logging (evidence: `openanima_app/app.py`)
- Recovery tools → Diagnostics logging: records actions (evidence: `openanima_app/runtime/recovery.py`)
