How andrea-ragalzi/koma-studio works
Koma Studio is a local-first Qt desktop app for manga project authoring. Users create or open a project, edit Story and Universe content, compose pages, optionally generate and review panel-image candidates, then export PNG pages. The graph preserves those distinct stages and the project persistence layer. Some capabilities are documented but their UI or implementation was not sampled; those links use README evidence or are omitted rather than inferred from folder structure.
Main entry points: AppController.cpp App controller · PageController.cpp Page composition · PanelGeneration.cpp Panel generation · AssetImporter.cpp Reference assets
Components 19
Application
- App controller
src/app/AppController.cpp - Settings
src/core/Settings.cpp - Project library
src/app/ProjectListModel.cpp
Story and Universe
- Story editing
src/app/WorkspaceController.cpp - Universe editing
src/app/WorkspaceController.cpp - Reference assets
src/storage/AssetImporter.cpp
Pages and Production
- Page composition
src/app/PageController.cpp - Panel layout model
src/domain/PanelLayout.cpp - Panel generation
src/app/PanelGeneration.cpp - Generation providers
src/app/GenerationProvider.cpp - Codex job
src/app/CodexGenerationJob.cpp - Candidate review
src/storage/GenerationStore.cpp - PNG page export
src/app/PageExport.cpp
Project Persistence
- Project store
src/storage/ProjectStore.cpp - Workspace store
src/storage/WorkspaceStore.cpp - Page store
src/storage/PageStore.cpp - Generation store
src/storage/GenerationStore.cpp - Project asset files
src/storage/AssetFiles.cpp
Other components
- Studio user
Connections 26
- Studio user → App controller: uses
README.md - App controller → Project library: manages
- App controller → Settings: configures
- App controller → Story editing: exposes
- App controller → Universe editing: exposes
- App controller → Page composition: exposes
- App controller → Project store: opens projects
- Story editing → Workspace store: reads and saves
- Universe editing → Workspace store: reads and saves
- Story editing → Reference assets: imports images
src/app/WorkspaceController.cpp - Universe editing → Reference assets: imports images
src/app/WorkspaceController.cpp - Workspace store → Project store: uses database
- Page composition → Page store: loads and saves
- Page composition → Workspace store: reads references
- Page composition → Panel layout model: uses layout
src/app/PageController.cpp - Page composition → Panel generation: starts generation
src/app/PanelGeneration.cpp - Panel generation → Generation providers: selects provider
src/app/PanelGeneration.cpp - Panel generation → Codex job: dispatches Codex
src/app/PanelGeneration.cpp - Panel generation → Generation store: records candidates
src/app/PanelGeneration.cpp - Panel generation → Reference assets: imports results
src/app/PanelGeneration.cpp - Candidate review → Generation store: reviews candidates
src/storage/GenerationStore.cpp - Page composition → PNG page export: exports pages
src/app/PageExport.cpp - PNG page export → Project asset files: reads images
src/app/PageExport.cpp - Generation store → Project store: uses database
- Page store → Project store: uses database
- Reference assets → Project asset files: resolves files