# openshot/openshot-qt architecture

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

- Interactive diagram: https://gitdiagram.com/openshot/openshot-qt
- Repository: https://github.com/openshot/openshot-qt

## Overview

OpenShot is a desktop video editor. Users assemble media on a multitrack timeline, edit clips and effects, preview the result, then export a rendered video; the README also documents titles, animation, audio, format interchange, and experimental hardware acceleration. The graph includes the application shell, editing and preview surfaces, AI generation, and the agent-based editing/export path. Source-index references and excerpts establish only some connections; unsampled feature modules are shown without guessed wiring.

Main entry points: [`src/classes/app.py`](https://github.com/openshot/openshot-qt/blob/develop/src/classes/app.py) (Application), [`src/windows/main_window.py`](https://github.com/openshot/openshot-qt/blob/develop/src/windows/main_window.py) (Main window), [`src/classes/agent/host.py`](https://github.com/openshot/openshot-qt/blob/develop/src/classes/agent/host.py) (Agent host), [`src/classes/agent/service.py`](https://github.com/openshot/openshot-qt/blob/develop/src/classes/agent/service.py) (Editing commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app["Application<br/>[app.py]"]
  node_main_window["Main window<br/>[main_window.py]"]
  node_project_store[("Project data<br/>[project_data.py]")]
  node_theme_manager["Theme manager<br/>[manager.py]"]
end

subgraph group_edit["Editing and preview"]
  node_timeline["Timeline editing<br/>[base.py]"]
  node_clip_queries["Project queries<br/>[query.py]"]
  node_preview["Playback preview<br/>[preview_thread.py]"]
end

subgraph group_media["Media and generation"]
  node_import_export["Format interchange"]
  node_titles["Text and titles<br/>[direct_text.py]"]
  node_ai_generation["AI generation"]
  node_ai_service["Generation service<br/>[comfy_client.py]"]
end

subgraph group_agent["Agent and export"]
  node_agent_host["Agent host<br/>[host.py]"]
  node_agent_service["Editing commands<br/>[service.py]"]
  node_agent_protocol["Agent protocol<br/>[protocol.py]"]
  node_export_check["Export validation<br/>[export_check.py]"]
  node_render["Render timeline<br/>[render.py]"]
  node_export_worker["Export worker<br/>[export_worker.py]"]
end

subgraph group_platform["Platform services"]
  node_qt["Qt binding<br/>[qt_api.py]"]
  node_theme_base["Theme base<br/>[base.py]"]
end

node_user(("Editor user"))

node_user -.->|"uses"| node_app
node_app -->|"shows"| node_main_window
node_app -->|"creates"| node_project_store
node_app -->|"instantiates"| node_theme_manager
node_app -.->|"starts"| node_agent_host
node_theme_manager -->|"applies themes"| node_theme_base
node_agent_host -->|"uses"| node_agent_service
node_agent_host -->|"uses"| node_agent_protocol
node_agent_service -->|"queries project"| node_clip_queries
node_agent_service -->|"uses"| node_agent_protocol
node_export_worker -->|"builds timeline"| node_render
node_export_worker -->|"checks settings"| node_export_check
node_ai_generation -->|"uses client"| node_ai_service
node_main_window -.->|"offers editing"| node_timeline
node_main_window -.->|"offers preview"| node_preview

click node_app "https://github.com/openshot/openshot-qt/blob/develop/src/classes/app.py"
click node_main_window "https://github.com/openshot/openshot-qt/blob/develop/src/windows/main_window.py"
click node_project_store "https://github.com/openshot/openshot-qt/blob/develop/src/classes/project_data.py"
click node_theme_manager "https://github.com/openshot/openshot-qt/blob/develop/src/themes/manager.py"
click node_timeline "https://github.com/openshot/openshot-qt/blob/develop/src/windows/views/timeline_backend/qwidget/base.py"
click node_clip_queries "https://github.com/openshot/openshot-qt/blob/develop/src/classes/query.py"
click node_preview "https://github.com/openshot/openshot-qt/blob/develop/src/windows/preview_thread.py"
click node_import_export "https://github.com/openshot/openshot-qt/tree/develop/src/classes/importers"
click node_titles "https://github.com/openshot/openshot-qt/blob/develop/src/classes/direct_text.py"
click node_ai_generation "https://github.com/openshot/openshot-qt/blob/develop/src/classes/generation_service.py"
click node_ai_service "https://github.com/openshot/openshot-qt/blob/develop/src/classes/comfy_client.py"
click node_agent_host "https://github.com/openshot/openshot-qt/blob/develop/src/classes/agent/host.py"
click node_agent_service "https://github.com/openshot/openshot-qt/blob/develop/src/classes/agent/service.py"
click node_agent_protocol "https://github.com/openshot/openshot-qt/blob/develop/src/classes/agent/protocol.py"
click node_export_check "https://github.com/openshot/openshot-qt/blob/develop/src/classes/agent/export_check.py"
click node_render "https://github.com/openshot/openshot-qt/blob/develop/src/classes/agent/render.py"
click node_export_worker "https://github.com/openshot/openshot-qt/blob/develop/src/classes/agent/export_worker.py"
click node_qt "https://github.com/openshot/openshot-qt/blob/develop/src/qt_api.py"
click node_theme_base "https://github.com/openshot/openshot-qt/blob/develop/src/themes/base.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_main_window,node_project_store,node_theme_manager,node_user toneBlue
class node_timeline,node_clip_queries,node_preview toneAmber
class node_import_export,node_titles,node_ai_generation,node_ai_service toneMint
class node_agent_host,node_agent_service,node_agent_protocol,node_export_check,node_render,node_export_worker toneRose
class node_qt,node_theme_base toneIndigo
```

## Components

### Application shell

- [Application](https://github.com/openshot/openshot-qt/blob/develop/src/classes/app.py): `src/classes/app.py`
- [Main window](https://github.com/openshot/openshot-qt/blob/develop/src/windows/main_window.py): `src/windows/main_window.py`
- [Project data](https://github.com/openshot/openshot-qt/blob/develop/src/classes/project_data.py): `src/classes/project_data.py`
- [Theme manager](https://github.com/openshot/openshot-qt/blob/develop/src/themes/manager.py): `src/themes/manager.py`

### Editing and preview

- [Timeline editing](https://github.com/openshot/openshot-qt/blob/develop/src/windows/views/timeline_backend/qwidget/base.py): `src/windows/views/timeline_backend/qwidget/base.py`
- [Project queries](https://github.com/openshot/openshot-qt/blob/develop/src/classes/query.py): `src/classes/query.py`
- [Playback preview](https://github.com/openshot/openshot-qt/blob/develop/src/windows/preview_thread.py): `src/windows/preview_thread.py`

### Media and generation

- [Format interchange](https://github.com/openshot/openshot-qt/tree/develop/src/classes/importers): `src/classes/importers`
- [Text and titles](https://github.com/openshot/openshot-qt/blob/develop/src/classes/direct_text.py): `src/classes/direct_text.py`
- [AI generation](https://github.com/openshot/openshot-qt/blob/develop/src/classes/generation_service.py): `src/classes/generation_service.py`
- [Generation service](https://github.com/openshot/openshot-qt/blob/develop/src/classes/comfy_client.py): `src/classes/comfy_client.py`

### Agent and export

- [Agent host](https://github.com/openshot/openshot-qt/blob/develop/src/classes/agent/host.py): `src/classes/agent/host.py`
- [Editing commands](https://github.com/openshot/openshot-qt/blob/develop/src/classes/agent/service.py): `src/classes/agent/service.py`
- [Agent protocol](https://github.com/openshot/openshot-qt/blob/develop/src/classes/agent/protocol.py): `src/classes/agent/protocol.py`
- [Export validation](https://github.com/openshot/openshot-qt/blob/develop/src/classes/agent/export_check.py): `src/classes/agent/export_check.py`
- [Render timeline](https://github.com/openshot/openshot-qt/blob/develop/src/classes/agent/render.py): `src/classes/agent/render.py`
- [Export worker](https://github.com/openshot/openshot-qt/blob/develop/src/classes/agent/export_worker.py): `src/classes/agent/export_worker.py`

### Platform services

- [Qt binding](https://github.com/openshot/openshot-qt/blob/develop/src/qt_api.py): `src/qt_api.py`
- [Theme base](https://github.com/openshot/openshot-qt/blob/develop/src/themes/base.py): `src/themes/base.py`

### Other components

- **Editor user**

## Connections

- Editor user → Application: uses
- Application → Main window: shows (evidence: `src/classes/app.py`)
- Application → Project data: creates (evidence: `src/classes/app.py`)
- Application → Theme manager: instantiates (evidence: `src/classes/app.py`)
- Application → Agent host: starts (evidence: `src/classes/app.py`)
- Theme manager → Theme base: applies themes (evidence: `src/themes/manager.py`)
- Agent host → Editing commands: uses (evidence: `src/classes/agent/host.py`)
- Agent host → Agent protocol: uses (evidence: `src/classes/agent/host.py`)
- Editing commands → Project queries: queries project (evidence: `src/classes/agent/service.py`)
- Editing commands → Agent protocol: uses (evidence: `src/classes/agent/service.py`)
- Export worker → Render timeline: builds timeline (evidence: `src/classes/agent/export_worker.py`)
- Export worker → Export validation: checks settings (evidence: `src/classes/agent/export_worker.py`)
- AI generation → Generation service: uses client (evidence: `src/classes/generation_service.py`)
- Main window → Timeline editing: offers editing
- Main window → Playback preview: offers preview
