# ekinstrop/unspektrawesome-source architecture

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

- Interactive diagram: https://gitdiagram.com/ekinstrop/unspektrawesome-source
- Repository: https://github.com/ekinstrop/unspektrawesome-source

## Overview

Unspektrawesome is an Android RAW camera app whose main path is camera selection and RAW stream planning, followed by Camera2 frame acquisition, Vulkan preview processing, and Spektra film rendering; still captures are processed and saved. The map also includes camera preferences and Spektra state/undo persistence. Several subsystems are represented by directory-level nodes because their files are in the tree but their implementations were not sampled; those links are omitted where the available evidence does not establish a call.

Main entry points: [`app/src/main/java/com/unspektrawesome/preview/RawVulkanPreviewController.kt`](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/preview/RawVulkanPreviewController.kt) (Preview controller), [`app/src/main/java/com/unspektrawesome/MainActivity.kt`](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/MainActivity.kt) (App activity), [`app/src/main/java/com/unspektrawesome/ui/camera/CameraScreen.kt`](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/ui/camera/CameraScreen.kt) (Camera screen), [`app/src/main/java/com/unspektrawesome/spektra/SpektraStateRepository.kt`](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/spektra/SpektraStateRepository.kt) (Film state repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_camera["Camera input"]
  node_catalog["Camera catalog<br/>[CameraCatalog.java]"]
  node_camera_domain["Camera descriptors"]
  node_preferences["Camera preferences"]
  node_route_planning["RAW stream planning"]
  node_raw_policy["Stream policy"]
  node_camera_session["Camera2 session"]
end

subgraph group_preview["Preview and capture"]
  node_preview_view["Preview view"]
  node_preview_controller["Preview controller"]
  node_capture_processing["Capture processing"]
  node_vulkan_bridge["Vulkan bridge<br/>[VulkanBridge.kt]"]
  node_vulkan_renderer["Vulkan renderer<br/>[VulkanRenderer.kt]"]
end

subgraph group_film["Spektra processing"]
  node_native_jni["Spektra JNI"]
  node_native_renderer["Native Vulkan renderer"]
  node_film_parameters["Film parameters"]
  node_film_state["Film state<br/>[SpektraState.kt]"]
  node_film_repository["Film state repository"]
  node_film_persistence["Film persistence"]
end

subgraph group_interface["App interface"]
  node_activity["App activity<br/>[MainActivity.kt]"]
  node_camera_ui["Camera screen<br/>[CameraScreen.kt]"]
  node_adjustments["Film controls"]
end

node_user(("Camera user"))
node_media_store[("Photo library")]
node_camera_service["Android camera service"]

node_user -->|"opens app"| node_activity
node_activity -->|"loads cameras"| node_catalog
node_activity -->|"loads settings"| node_preferences
node_activity -->|"shows screen"| node_camera_ui
node_activity -->|"creates controller"| node_preview_controller
node_activity -->|"provides state"| node_film_repository
node_camera_ui -->|"reads settings"| node_preferences
node_camera_ui -->|"edits film state"| node_film_repository
node_camera_ui -->|"shows controls"| node_adjustments
node_camera_ui -.->|"selects preview"| node_route_planning
node_route_planning -->|"chooses stream"| node_raw_policy
node_route_planning -->|"reads selection"| node_preferences
node_route_planning -->|"checks capabilities"| node_camera_domain
node_preview_controller -->|"starts session"| node_camera_session
node_camera_session -.->|"configures capture"| node_camera_service
node_preview_view -->|"attaches surface"| node_preview_controller
node_preview_controller -->|"captures state"| node_film_repository
node_preview_controller -->|"builds render parameters"| node_film_parameters
node_preview_controller -->|"prepares capture"| node_capture_processing
node_preview_controller -.->|"renders RAW frame"| node_vulkan_bridge
node_capture_processing -.->|"saves photo"| node_media_store
node_vulkan_bridge -.->|"dispatches rendering"| node_vulkan_renderer
node_vulkan_bridge -.->|"calls native code"| node_native_jni
node_native_jni -->|"uses renderer"| node_native_renderer
node_film_repository -->|"loads and saves"| node_film_persistence
node_film_repository -->|"publishes state"| node_film_state
node_film_state -.->|"holds parameters"| node_film_parameters

click node_activity "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/MainActivity.kt"
click node_camera_ui "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/ui/camera/CameraScreen.kt"
click node_adjustments "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/ui/camera/SpektraAdjustmentTray.kt"
click node_catalog "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/camera/CameraCatalog.java"
click node_camera_domain "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/camera/CameraDescriptor.java"
click node_preferences "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/settings/CameraPreferences.kt"
click node_route_planning "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/preview/RawPreviewPlanSelector.kt"
click node_raw_policy "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/camera/RawPreviewPolicy.java"
click node_camera_session "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/camera/session/Camera2RawSession.java"
click node_preview_view "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/preview/VulkanRawPreviewView.kt"
click node_preview_controller "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/preview/RawVulkanPreviewController.kt"
click node_capture_processing "https://github.com/ekinstrop/unspektrawesome-source/tree/main/app/src/main/java/com/unspektrawesome/capture"
click node_vulkan_bridge "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/vulkan/VulkanBridge.kt"
click node_vulkan_renderer "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/vulkan/VulkanRenderer.kt"
click node_native_jni "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/cpp/spektrafilm_android_jni.cpp"
click node_native_renderer "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/cpp/spektrafilm/src/SpektraVulkanRenderer.cpp"
click node_film_parameters "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/spektra/SpektraFilmParams.kt"
click node_film_state "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/spektra/SpektraState.kt"
click node_film_repository "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/spektra/SpektraStateRepository.kt"
click node_film_persistence "https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/spektra/SpektraStatePersistence.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_catalog,node_camera_domain,node_preferences,node_route_planning,node_raw_policy,node_camera_session,node_user toneBlue
class node_preview_view,node_preview_controller,node_capture_processing,node_vulkan_bridge,node_vulkan_renderer,node_media_store toneAmber
class node_native_jni,node_native_renderer,node_film_parameters,node_film_state,node_film_repository,node_film_persistence toneMint
class node_activity,node_camera_ui,node_adjustments toneRose
class node_camera_service toneIndigo
```

## Components

### Camera input

- [Camera catalog](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/camera/CameraCatalog.java): `app/src/main/java/com/unspektrawesome/camera/CameraCatalog.java`
- [Camera descriptors](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/camera/CameraDescriptor.java): `app/src/main/java/com/unspektrawesome/camera/CameraDescriptor.java`
- [Camera preferences](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/settings/CameraPreferences.kt): `app/src/main/java/com/unspektrawesome/settings/CameraPreferences.kt`
- [RAW stream planning](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/preview/RawPreviewPlanSelector.kt): `app/src/main/java/com/unspektrawesome/preview/RawPreviewPlanSelector.kt`
- [Stream policy](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/camera/RawPreviewPolicy.java): `app/src/main/java/com/unspektrawesome/camera/RawPreviewPolicy.java`
- [Camera2 session](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/camera/session/Camera2RawSession.java): `app/src/main/java/com/unspektrawesome/camera/session/Camera2RawSession.java`

### Preview and capture

- [Preview view](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/preview/VulkanRawPreviewView.kt): `app/src/main/java/com/unspektrawesome/preview/VulkanRawPreviewView.kt`
- [Preview controller](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/preview/RawVulkanPreviewController.kt): `app/src/main/java/com/unspektrawesome/preview/RawVulkanPreviewController.kt`
- [Capture processing](https://github.com/ekinstrop/unspektrawesome-source/tree/main/app/src/main/java/com/unspektrawesome/capture): `app/src/main/java/com/unspektrawesome/capture`
- [Vulkan bridge](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/vulkan/VulkanBridge.kt): `app/src/main/java/com/unspektrawesome/vulkan/VulkanBridge.kt`
- [Vulkan renderer](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/vulkan/VulkanRenderer.kt): `app/src/main/java/com/unspektrawesome/vulkan/VulkanRenderer.kt`

### Spektra processing

- [Spektra JNI](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/cpp/spektrafilm_android_jni.cpp): `app/src/main/cpp/spektrafilm_android_jni.cpp`
- [Native Vulkan renderer](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/cpp/spektrafilm/src/SpektraVulkanRenderer.cpp): `app/src/main/cpp/spektrafilm/src/SpektraVulkanRenderer.cpp`
- [Film parameters](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/spektra/SpektraFilmParams.kt): `app/src/main/java/com/unspektrawesome/spektra/SpektraFilmParams.kt`
- [Film state](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/spektra/SpektraState.kt): `app/src/main/java/com/unspektrawesome/spektra/SpektraState.kt`
- [Film state repository](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/spektra/SpektraStateRepository.kt): `app/src/main/java/com/unspektrawesome/spektra/SpektraStateRepository.kt`
- [Film persistence](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/spektra/SpektraStatePersistence.kt): `app/src/main/java/com/unspektrawesome/spektra/SpektraStatePersistence.kt`

### App interface

- [App activity](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/MainActivity.kt): `app/src/main/java/com/unspektrawesome/MainActivity.kt`
- [Camera screen](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/ui/camera/CameraScreen.kt): `app/src/main/java/com/unspektrawesome/ui/camera/CameraScreen.kt`
- [Film controls](https://github.com/ekinstrop/unspektrawesome-source/blob/main/app/src/main/java/com/unspektrawesome/ui/camera/SpektraAdjustmentTray.kt): `app/src/main/java/com/unspektrawesome/ui/camera/SpektraAdjustmentTray.kt`

### Other components

- **Camera user**
- **Photo library**
- **Android camera service**

## Connections

- Camera user → App activity: opens app (evidence: `README.md`)
- App activity → Camera catalog: loads cameras (evidence: `app/src/main/java/com/unspektrawesome/MainActivity.kt`)
- App activity → Camera preferences: loads settings (evidence: `app/src/main/java/com/unspektrawesome/MainActivity.kt`)
- App activity → Camera screen: shows screen (evidence: `app/src/main/java/com/unspektrawesome/MainActivity.kt`)
- App activity → Preview controller: creates controller (evidence: `app/src/main/java/com/unspektrawesome/MainActivity.kt`)
- App activity → Film state repository: provides state (evidence: `app/src/main/java/com/unspektrawesome/MainActivity.kt`)
- Camera screen → Camera preferences: reads settings (evidence: `app/src/main/java/com/unspektrawesome/ui/camera/CameraScreen.kt`)
- Camera screen → Film state repository: edits film state (evidence: `app/src/main/java/com/unspektrawesome/ui/camera/CameraScreen.kt`)
- Camera screen → Film controls: shows controls (evidence: `app/src/main/java/com/unspektrawesome/ui/camera/CameraScreen.kt`)
- Camera screen → RAW stream planning: selects preview
- RAW stream planning → Stream policy: chooses stream (evidence: `app/src/main/java/com/unspektrawesome/preview/RawPreviewPlanSelector.kt`)
- RAW stream planning → Camera preferences: reads selection (evidence: `app/src/main/java/com/unspektrawesome/preview/RawPreviewPlanSelector.kt`)
- RAW stream planning → Camera descriptors: checks capabilities (evidence: `app/src/main/java/com/unspektrawesome/preview/RawPreviewPlanSelector.kt`)
- Preview controller → Camera2 session: starts session (evidence: `app/src/main/java/com/unspektrawesome/preview/RawVulkanPreviewController.kt`)
- Camera2 session → Android camera service: configures capture
- Preview view → Preview controller: attaches surface (evidence: `app/src/main/java/com/unspektrawesome/preview/VulkanRawPreviewView.kt`)
- Preview controller → Film state repository: captures state (evidence: `app/src/main/java/com/unspektrawesome/preview/RawVulkanPreviewController.kt`)
- Preview controller → Film parameters: builds render parameters (evidence: `app/src/main/java/com/unspektrawesome/preview/RawVulkanPreviewController.kt`)
- Preview controller → Capture processing: prepares capture (evidence: `app/src/main/java/com/unspektrawesome/preview/RawVulkanPreviewController.kt`)
- Preview controller → Vulkan bridge: renders RAW frame
- Capture processing → Photo library: saves photo
- Vulkan bridge → Vulkan renderer: dispatches rendering
- Vulkan bridge → Spektra JNI: calls native code
- Spektra JNI → Native Vulkan renderer: uses renderer (evidence: `app/src/main/cpp/spektrafilm_android_jni.cpp`)
- Film state repository → Film persistence: loads and saves (evidence: `app/src/main/java/com/unspektrawesome/spektra/SpektraStateRepository.kt`)
- Film state repository → Film state: publishes state (evidence: `app/src/main/java/com/unspektrawesome/spektra/SpektraStateRepository.kt`)
- Film state → Film parameters: holds parameters (evidence: `app/src/main/java/com/unspektrawesome/spektra/SpektraState.kt`)
