# avinashcreates/creatorcam architecture

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

- Interactive diagram: https://gitdiagram.com/avinashcreates/creatorcam
- Repository: https://github.com/avinashcreates/creatorcam

## Overview

CreatorCam is an Android camera app whose main workflow is camera preview and optional face analysis, live effects/avatar rendering, then photo or video capture and review. The view model coordinates camera, renderer, recorder, settings, and storage; the renderer produces the shared processed image for preview and recording. Review supports retake, save, share, and delete. Documented capabilities also include voice DSP before audio encoding, configurable avatars, permission handling, and camera settings. Edges rely on README statements and the supplied source excerpts/index; some UI and subsystem internals were not sampled.

Main entry points: [`app/src/main/java/com/avinash/creatorcam/ui/CameraViewModel.kt`](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/CameraViewModel.kt) (Capture coordinator), [`app/src/main/java/com/avinash/creatorcam/gl/CameraRenderer.kt`](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/gl/CameraRenderer.kt) (GL renderer), [`app/src/main/java/com/avinash/creatorcam/camera/CameraController.kt`](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/camera/CameraController.kt) (Camera session), [`app/src/main/java/com/avinash/creatorcam/ui/AppRoot.kt`](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/AppRoot.kt) (App root)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and capture UI"]
  node_activity["App entry<br/>[MainActivity.kt]"]
  node_root["App root<br/>[AppRoot.kt]"]
  node_camera_ui["Camera UI<br/>[CameraScreen.kt]"]
  node_panels["Capture controls<br/>[CameraPanels.kt]"]
  node_permissions["Permissions<br/>[Permissions.kt]"]
  node_viewmodel["Capture coordinator<br/>[CameraViewModel.kt]"]
  node_settings_ui["Settings panel<br/>[SettingsSheet.kt]"]
  node_settings["App settings<br/>[AppSettings.kt]"]
  node_review_ui["Review screen<br/>[ReviewScreen.kt]"]
end

subgraph group_camera["Camera and face tracking"]
  node_camera_controller["Camera session"]
  node_analyzer["Face analyzer<br/>[FaceAnalyzer.kt]"]
  node_geometry["Face geometry<br/>[FaceGeometry.kt]"]
  node_tracker["Pose tracker<br/>[FaceTracker.kt]"]
end

subgraph group_render["Effects and rendering"]
  node_effects["Image effects<br/>[Effects.kt]"]
  node_avatar["Avatar presets<br/>[AvatarSpec.kt]"]
  node_renderer["GL renderer<br/>[CameraRenderer.kt]"]
  node_egl["EGL context<br/>[EglCore.kt]"]
  node_orientation["Orientation mapping<br/>[Orientation.kt]"]
  node_shaders["GL shaders<br/>[Shaders.kt]"]
end

subgraph group_media["Recording and media"]
  node_recorder["MP4 recorder<br/>[Mp4Recorder.kt]"]
  node_voice["Voice DSP<br/>[VoiceEffects.kt]"]
  node_storage["Media storage<br/>[MediaStorage.kt]"]
  node_player["Media3 player"]
end

node_user(("Creator"))
node_camera_service["CameraX"]
node_mediastore[("Android MediaStore")]
node_share["Android sharesheet"]

node_user -->|"opens app"| node_root
node_activity -->|"starts"| node_root
node_root -->|"creates"| node_viewmodel
node_root -->|"shows"| node_camera_ui
node_root -->|"shows"| node_review_ui
node_camera_ui -->|"dispatches actions"| node_viewmodel
node_camera_ui -->|"renders"| node_panels
node_camera_ui -.->|"requests access"| node_permissions
node_settings_ui -->|"updates"| node_viewmodel
node_viewmodel -->|"controls session"| node_camera_controller
node_viewmodel -->|"configures capture"| node_renderer
node_viewmodel -->|"starts recording"| node_recorder
node_viewmodel -->|"creates takes"| node_storage
node_viewmodel -->|"loads preferences"| node_settings
node_viewmodel -.->|"provides state"| node_settings_ui
node_camera_controller -->|"binds camera"| node_camera_service
node_camera_controller -->|"feeds preview"| node_renderer
node_camera_controller -->|"feeds analysis"| node_analyzer
node_camera_controller -->|"resets tracker"| node_tracker
node_analyzer -->|"measures face"| node_geometry
node_analyzer -->|"sends measurements"| node_tracker
node_renderer -->|"reads pose"| node_tracker
node_renderer -->|"draws avatar"| node_avatar
node_renderer -->|"uses parameters"| node_effects
node_renderer -->|"creates GL context"| node_egl
node_renderer -->|"maps frames"| node_orientation
node_renderer -->|"renders pixels"| node_shaders
node_recorder -->|"receives GL frames"| node_renderer
node_recorder -->|"processes PCM"| node_voice
node_viewmodel -.->|"provides take state"| node_review_ui
node_review_ui -->|"plays take"| node_player
node_review_ui -->|"dispatches review actions"| node_viewmodel
node_viewmodel -->|"saves or shares"| node_storage
node_storage -->|"copies saved media"| node_mediastore
node_storage -->|"creates share intent"| node_share

click node_activity "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/MainActivity.kt"
click node_root "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/AppRoot.kt"
click node_camera_ui "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/CameraScreen.kt"
click node_panels "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/CameraPanels.kt"
click node_permissions "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/Permissions.kt"
click node_viewmodel "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/CameraViewModel.kt"
click node_settings_ui "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/SettingsSheet.kt"
click node_settings "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/settings/AppSettings.kt"
click node_review_ui "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/ReviewScreen.kt"
click node_camera_controller "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/camera/CameraController.kt"
click node_analyzer "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/face/FaceAnalyzer.kt"
click node_geometry "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/face/FaceGeometry.kt"
click node_tracker "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/face/FaceTracker.kt"
click node_effects "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/effects/Effects.kt"
click node_avatar "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/avatar/AvatarSpec.kt"
click node_renderer "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/gl/CameraRenderer.kt"
click node_egl "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/gl/EglCore.kt"
click node_orientation "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/gl/Orientation.kt"
click node_shaders "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/gl/Shaders.kt"
click node_recorder "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/record/Mp4Recorder.kt"
click node_voice "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/audio/VoiceEffects.kt"
click node_storage "https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/storage/MediaStorage.kt"

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_activity,node_root,node_camera_ui,node_panels,node_permissions,node_viewmodel,node_settings_ui,node_settings,node_review_ui toneBlue
class node_camera_controller,node_analyzer,node_geometry,node_tracker,node_mediastore toneAmber
class node_effects,node_avatar,node_renderer,node_egl,node_orientation,node_shaders toneMint
class node_recorder,node_voice,node_storage,node_player toneRose
class node_user,node_camera_service,node_share toneIndigo
```

## Components

### App and capture UI

- [App entry](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/MainActivity.kt): `app/src/main/java/com/avinash/creatorcam/MainActivity.kt`
- [App root](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/AppRoot.kt): `app/src/main/java/com/avinash/creatorcam/ui/AppRoot.kt`
- [Camera UI](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/CameraScreen.kt): `app/src/main/java/com/avinash/creatorcam/ui/CameraScreen.kt`
- [Capture controls](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/CameraPanels.kt): `app/src/main/java/com/avinash/creatorcam/ui/CameraPanels.kt`
- [Permissions](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/Permissions.kt): `app/src/main/java/com/avinash/creatorcam/ui/Permissions.kt`
- [Capture coordinator](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/CameraViewModel.kt): `app/src/main/java/com/avinash/creatorcam/ui/CameraViewModel.kt`
- [Settings panel](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/SettingsSheet.kt): `app/src/main/java/com/avinash/creatorcam/ui/SettingsSheet.kt`
- [App settings](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/settings/AppSettings.kt): `app/src/main/java/com/avinash/creatorcam/settings/AppSettings.kt`
- [Review screen](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/ui/ReviewScreen.kt): `app/src/main/java/com/avinash/creatorcam/ui/ReviewScreen.kt`

### Camera and face tracking

- [Camera session](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/camera/CameraController.kt): `app/src/main/java/com/avinash/creatorcam/camera/CameraController.kt`
- [Face analyzer](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/face/FaceAnalyzer.kt): `app/src/main/java/com/avinash/creatorcam/face/FaceAnalyzer.kt`
- [Face geometry](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/face/FaceGeometry.kt): `app/src/main/java/com/avinash/creatorcam/face/FaceGeometry.kt`
- [Pose tracker](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/face/FaceTracker.kt): `app/src/main/java/com/avinash/creatorcam/face/FaceTracker.kt`

### Effects and rendering

- [Image effects](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/effects/Effects.kt): `app/src/main/java/com/avinash/creatorcam/effects/Effects.kt`
- [Avatar presets](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/avatar/AvatarSpec.kt): `app/src/main/java/com/avinash/creatorcam/avatar/AvatarSpec.kt`
- [GL renderer](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/gl/CameraRenderer.kt): `app/src/main/java/com/avinash/creatorcam/gl/CameraRenderer.kt`
- [EGL context](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/gl/EglCore.kt): `app/src/main/java/com/avinash/creatorcam/gl/EglCore.kt`
- [Orientation mapping](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/gl/Orientation.kt): `app/src/main/java/com/avinash/creatorcam/gl/Orientation.kt`
- [GL shaders](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/gl/Shaders.kt): `app/src/main/java/com/avinash/creatorcam/gl/Shaders.kt`

### Recording and media

- [MP4 recorder](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/record/Mp4Recorder.kt): `app/src/main/java/com/avinash/creatorcam/record/Mp4Recorder.kt`
- [Voice DSP](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/audio/VoiceEffects.kt): `app/src/main/java/com/avinash/creatorcam/audio/VoiceEffects.kt`
- [Media storage](https://github.com/avinashcreates/creatorcam/blob/main/app/src/main/java/com/avinash/creatorcam/storage/MediaStorage.kt): `app/src/main/java/com/avinash/creatorcam/storage/MediaStorage.kt`
- **Media3 player**

### Other components

- **Creator**
- **CameraX**
- **Android MediaStore**
- **Android sharesheet**

## Connections

- Creator → App root: opens app (evidence: `README.md`)
- App entry → App root: starts (evidence: `app/src/main/java/com/avinash/creatorcam/MainActivity.kt`)
- App root → Capture coordinator: creates (evidence: `app/src/main/java/com/avinash/creatorcam/ui/AppRoot.kt`)
- App root → Camera UI: shows (evidence: `app/src/main/java/com/avinash/creatorcam/ui/AppRoot.kt`)
- App root → Review screen: shows (evidence: `app/src/main/java/com/avinash/creatorcam/ui/AppRoot.kt`)
- Camera UI → Capture coordinator: dispatches actions (evidence: `app/src/main/java/com/avinash/creatorcam/ui/CameraScreen.kt`)
- Camera UI → Capture controls: renders (evidence: `app/src/main/java/com/avinash/creatorcam/ui/CameraScreen.kt`)
- Camera UI → Permissions: requests access (evidence: `README.md`)
- Settings panel → Capture coordinator: updates (evidence: `app/src/main/java/com/avinash/creatorcam/ui/SettingsSheet.kt`)
- Capture coordinator → Camera session: controls session (evidence: `app/src/main/java/com/avinash/creatorcam/ui/CameraViewModel.kt`)
- Capture coordinator → GL renderer: configures capture (evidence: `app/src/main/java/com/avinash/creatorcam/ui/CameraViewModel.kt`)
- Capture coordinator → MP4 recorder: starts recording (evidence: `app/src/main/java/com/avinash/creatorcam/ui/CameraViewModel.kt`)
- Capture coordinator → Media storage: creates takes (evidence: `app/src/main/java/com/avinash/creatorcam/ui/CameraViewModel.kt`)
- Capture coordinator → App settings: loads preferences (evidence: `app/src/main/java/com/avinash/creatorcam/ui/CameraViewModel.kt`)
- Capture coordinator → Settings panel: provides state (evidence: `app/src/main/java/com/avinash/creatorcam/ui/SettingsSheet.kt`)
- Camera session → CameraX: binds camera (evidence: `app/src/main/java/com/avinash/creatorcam/camera/CameraController.kt`)
- Camera session → GL renderer: feeds preview (evidence: `README.md`)
- Camera session → Face analyzer: feeds analysis (evidence: `README.md`)
- Camera session → Pose tracker: resets tracker (evidence: `app/src/main/java/com/avinash/creatorcam/camera/CameraController.kt`)
- Face analyzer → Face geometry: measures face (evidence: `app/src/main/java/com/avinash/creatorcam/face/FaceAnalyzer.kt`)
- Face analyzer → Pose tracker: sends measurements (evidence: `app/src/main/java/com/avinash/creatorcam/face/FaceAnalyzer.kt`)
- GL renderer → Pose tracker: reads pose (evidence: `README.md`)
- GL renderer → Avatar presets: draws avatar (evidence: `README.md`)
- GL renderer → Image effects: uses parameters (evidence: `README.md`)
- GL renderer → EGL context: creates GL context (evidence: `app/src/main/java/com/avinash/creatorcam/gl/CameraRenderer.kt`)
- GL renderer → Orientation mapping: maps frames (evidence: `app/src/main/java/com/avinash/creatorcam/gl/CameraRenderer.kt`)
- GL renderer → GL shaders: renders pixels (evidence: `README.md`)
- MP4 recorder → GL renderer: receives GL frames (evidence: `README.md`)
- MP4 recorder → Voice DSP: processes PCM (evidence: `README.md`)
- Capture coordinator → Review screen: provides take state
- Review screen → Media3 player: plays take (evidence: `README.md`)
- Review screen → Capture coordinator: dispatches review actions (evidence: `app/src/main/java/com/avinash/creatorcam/ui/ReviewScreen.kt`)
- Capture coordinator → Media storage: saves or shares (evidence: `README.md`)
- Media storage → Android MediaStore: copies saved media (evidence: `app/src/main/java/com/avinash/creatorcam/storage/MediaStorage.kt`)
- Media storage → Android sharesheet: creates share intent (evidence: `app/src/main/java/com/avinash/creatorcam/storage/MediaStorage.kt`)
