# katboi01/umaviewer architecture

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

- Interactive diagram: https://gitdiagram.com/katboi01/umaviewer
- Repository: https://github.com/katboi01/umaviewer

## Overview

Uma Viewer is a Unity application for browsing Uma Musume game assets. The documented workflow is to launch the viewer, let it detect the game-data folder or select that folder in Settings, then view and manipulate models and animations or use the listed playback and capture features. The tree provides no application source excerpts, so implementation nodes use the existing Assets directory and edges are limited to relationships stated in the README; internal call structure cannot be verified.

Main entry points: [`Assets`](https://github.com/katboi01/umaviewer/tree/master/Assets) (Uma Viewer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Viewer and data"]
  node_viewer["Uma Viewer"]
  node_game_data[("Game data folder")]
  node_data_setup["Data path setup"]
end

subgraph group_models["Model viewing"]
  node_character_models["Character models"]
  node_chibi_models["Chibi models"]
  node_mob_models["Mob models"]
  node_costumes["Costume swapping"]
  node_animation["Animation viewing"]
  node_facial["Facial controls"]
  node_physics["Cloth and hair"]
end

subgraph group_media["Playback and output"]
  node_live_audio["Live audio lyrics"]
  node_mmd_export["MMD export"]
  node_recording["GIF and screenshots"]
end

node_user(("Viewer user"))

node_user -->|"launches"| node_viewer
node_viewer -->|"detects path"| node_data_setup
node_user -->|"sets path"| node_data_setup
node_data_setup -->|"selects folder"| node_game_data
node_viewer -->|"loads assets"| node_game_data
node_viewer -->|"views"| node_character_models
node_viewer -->|"views"| node_chibi_models
node_viewer -->|"views"| node_mob_models
node_viewer -->|"swaps costumes"| node_costumes
node_viewer -->|"plays animations"| node_animation
node_viewer -->|"controls faces"| node_facial
node_viewer -->|"shows physics"| node_physics
node_viewer -->|"plays audio"| node_live_audio
node_viewer -->|"exports animation"| node_mmd_export
node_viewer -->|"captures output"| node_recording

click node_viewer "https://github.com/katboi01/umaviewer/tree/master/Assets"
click node_data_setup "https://github.com/katboi01/umaviewer/tree/master/Assets"
click node_character_models "https://github.com/katboi01/umaviewer/tree/master/Assets"
click node_chibi_models "https://github.com/katboi01/umaviewer/tree/master/Assets"
click node_mob_models "https://github.com/katboi01/umaviewer/tree/master/Assets"
click node_costumes "https://github.com/katboi01/umaviewer/tree/master/Assets"
click node_animation "https://github.com/katboi01/umaviewer/tree/master/Assets"
click node_facial "https://github.com/katboi01/umaviewer/tree/master/Assets"
click node_physics "https://github.com/katboi01/umaviewer/tree/master/Assets"
click node_live_audio "https://github.com/katboi01/umaviewer/tree/master/Assets"
click node_mmd_export "https://github.com/katboi01/umaviewer/tree/master/Assets"
click node_recording "https://github.com/katboi01/umaviewer/tree/master/Assets"

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_viewer,node_game_data,node_data_setup,node_user toneBlue
class node_character_models,node_chibi_models,node_mob_models,node_costumes,node_animation,node_facial,node_physics toneAmber
class node_live_audio,node_mmd_export,node_recording toneMint
```

## Components

### Viewer and data

- [Uma Viewer](https://github.com/katboi01/umaviewer/tree/master/Assets): `Assets`
- **Game data folder**
- [Data path setup](https://github.com/katboi01/umaviewer/tree/master/Assets): `Assets`

### Model viewing

- [Character models](https://github.com/katboi01/umaviewer/tree/master/Assets): `Assets`
- [Chibi models](https://github.com/katboi01/umaviewer/tree/master/Assets): `Assets`
- [Mob models](https://github.com/katboi01/umaviewer/tree/master/Assets): `Assets`
- [Costume swapping](https://github.com/katboi01/umaviewer/tree/master/Assets): `Assets`
- [Animation viewing](https://github.com/katboi01/umaviewer/tree/master/Assets): `Assets`
- [Facial controls](https://github.com/katboi01/umaviewer/tree/master/Assets): `Assets`
- [Cloth and hair](https://github.com/katboi01/umaviewer/tree/master/Assets): `Assets`

### Playback and output

- [Live audio lyrics](https://github.com/katboi01/umaviewer/tree/master/Assets): `Assets`
- [MMD export](https://github.com/katboi01/umaviewer/tree/master/Assets): `Assets`
- [GIF and screenshots](https://github.com/katboi01/umaviewer/tree/master/Assets): `Assets`

### Other components

- **Viewer user**

## Connections

- Viewer user → Uma Viewer: launches (evidence: `README.md`)
- Uma Viewer → Data path setup: detects path (evidence: `README.md`)
- Viewer user → Data path setup: sets path (evidence: `README.md`)
- Data path setup → Game data folder: selects folder (evidence: `README.md`)
- Uma Viewer → Game data folder: loads assets (evidence: `README.md`)
- Uma Viewer → Character models: views (evidence: `README.md`)
- Uma Viewer → Chibi models: views (evidence: `README.md`)
- Uma Viewer → Mob models: views (evidence: `README.md`)
- Uma Viewer → Costume swapping: swaps costumes (evidence: `README.md`)
- Uma Viewer → Animation viewing: plays animations (evidence: `README.md`)
- Uma Viewer → Facial controls: controls faces (evidence: `README.md`)
- Uma Viewer → Cloth and hair: shows physics (evidence: `README.md`)
- Uma Viewer → Live audio lyrics: plays audio (evidence: `README.md`)
- Uma Viewer → MMD export: exports animation (evidence: `README.md`)
- Uma Viewer → GIF and screenshots: captures output (evidence: `README.md`)
