# jegly/gallery architecture

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

- Interactive diagram: https://gitdiagram.com/jegly/gallery
- Repository: https://github.com/jegly/gallery

## Overview

Gallery is an offline Android photo and video gallery. Users browse and organize device media, view or play it, and optionally edit images and save changes or a copy. The map follows navigation into library screens, media access and actions, then the editor/native image engine. The README documents several capabilities whose exact wiring is not shown in sampled source; those branches are retained without speculative implementation links.

Main entry points: [`app/src/main/java/com/gal/ui/screens`](https://github.com/jegly/gallery/tree/main/app/src/main/java/com/gal/ui/screens) (Library screens), [`app/src/main/java/com/gal/editor/EditorViewModel.kt`](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/editor/EditorViewModel.kt) (Editor view model), [`app/src/main/java/com/gal/editor/EditorScreen.kt`](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/editor/EditorScreen.kt) (Editor screen), [`native/grainhouse/src/pipeline.rs`](https://github.com/jegly/gallery/blob/main/native/grainhouse/src/pipeline.rs) (Edit pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Gallery app"]
  node_activity["App activity<br/>[MainActivity.kt]"]
  node_navigation["Navigation<br/>[Navigation.kt]"]
  node_settings["Settings<br/>[SettingsScreen.kt]"]
end

subgraph group_library["Media library"]
  node_screens["Library screens"]
  node_grid["Media grid<br/>[MediaGrid.kt]"]
  node_viewer["Media viewer"]
  node_intentviewer["Intent viewer"]
  node_video["Video playback<br/>[VideoPlayer.kt]"]
  node_actions["Media actions"]
  node_repository["Media repository<br/>[MediaRepository.kt]"]
  node_local["Local media source<br/>[LocalDataSource.kt]"]
  node_refresh["Media refresh"]
  node_rawformats["RAW formats<br/>[RawFormats.kt]"]
  node_rawfetch["RAW preview fetcher"]
  node_rawreader["RAW preview reader"]
end

subgraph group_editing["Photo editing"]
  node_editoractivity["Editor activity<br/>[EditActivity.kt]"]
  node_editorscreen["Editor screen<br/>[EditorScreen.kt]"]
  node_editvm["Editor view model<br/>[EditorViewModel.kt]"]
  node_editdoc["Edit document<br/>[EditDoc.kt]"]
  node_jni["JNI bridge"]
end

subgraph group_engine["Grainhouse engine"]
  node_native["Native editor bridge<br/>[lib.rs]"]
  node_pipeline["Edit pipeline<br/>[pipeline.rs]"]
  node_adjust["Image adjustments<br/>[adjust.rs]"]
  node_camera["Camera processing<br/>[camera.rs]"]
  node_image["Image model<br/>[img.rs]"]
  node_lut["Color LUTs<br/>[lut.rs]"]
end

node_user(("Gallery user"))

node_user -->|"opens"| node_activity
node_navigation -->|"routes to"| node_screens
node_screens -->|"queries media"| node_repository
node_screens -->|"renders"| node_grid
node_screens -->|"requests actions"| node_actions
node_screens -.->|"browses media"| node_viewer
node_screens -.->|"handles shared media"| node_intentviewer
node_viewer -.->|"plays video"| node_video
node_actions -->|"delegates actions"| node_repository
node_repository -->|"reads media"| node_local
node_activity -->|"refreshes media"| node_refresh
node_rawfetch -->|"checks formats"| node_rawformats
node_rawfetch -->|"extracts preview"| node_rawreader
node_editoractivity -->|"hosts"| node_editorscreen
node_editorscreen -->|"controls"| node_editvm
node_editorscreen -->|"displays"| node_editdoc
node_editvm -->|"updates"| node_editdoc
node_editvm -->|"checks formats"| node_rawformats
node_editvm -->|"invokes"| node_jni
node_jni -.->|"calls native"| node_native
node_native -.->|"runs edits"| node_pipeline
node_pipeline -->|"uses adjustments"| node_adjust
node_pipeline -->|"uses camera tools"| node_camera
node_adjust -->|"processes pixels"| node_image
node_adjust -->|"uses lookups"| node_lut
node_camera -->|"processes pixels"| node_image

click node_activity "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/MainActivity.kt"
click node_navigation "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/navigation/Navigation.kt"
click node_settings "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/screens/settings/SettingsScreen.kt"
click node_screens "https://github.com/jegly/gallery/tree/main/app/src/main/java/com/gal/ui/screens"
click node_grid "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/components/MediaGrid.kt"
click node_viewer "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/screens/viewer/MediaViewerScreen.kt"
click node_intentviewer "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/screens/viewer/IntentViewerScreen.kt"
click node_video "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/screens/viewer/VideoPlayer.kt"
click node_actions "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/actions/MediaActionsViewModel.kt"
click node_repository "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/data/repository/MediaRepository.kt"
click node_local "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/data/local/LocalDataSource.kt"
click node_refresh "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/data/local/MediaStoreRefresher.kt"
click node_rawformats "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/data/raw/RawFormats.kt"
click node_rawfetch "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/data/raw/RawPreviewFetcher.kt"
click node_rawreader "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/data/raw/RawPreviewReader.kt"
click node_editoractivity "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/screens/editor/EditActivity.kt"
click node_editorscreen "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/editor/EditorScreen.kt"
click node_editvm "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/editor/EditorViewModel.kt"
click node_editdoc "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/editor/EditDoc.kt"
click node_jni "https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/editor/GrainhouseNative.kt"
click node_native "https://github.com/jegly/gallery/blob/main/native/editor/src/lib.rs"
click node_pipeline "https://github.com/jegly/gallery/blob/main/native/grainhouse/src/pipeline.rs"
click node_adjust "https://github.com/jegly/gallery/blob/main/native/grainhouse/src/adjust.rs"
click node_camera "https://github.com/jegly/gallery/blob/main/native/grainhouse/src/camera.rs"
click node_image "https://github.com/jegly/gallery/blob/main/native/grainhouse/src/img.rs"
click node_lut "https://github.com/jegly/gallery/blob/main/native/grainhouse/src/lut.rs"

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_navigation,node_settings,node_user toneBlue
class node_screens,node_grid,node_viewer,node_intentviewer,node_video,node_actions,node_repository,node_local,node_refresh,node_rawformats,node_rawfetch,node_rawreader toneAmber
class node_editoractivity,node_editorscreen,node_editvm,node_editdoc,node_jni toneMint
class node_native,node_pipeline,node_adjust,node_camera,node_image,node_lut toneRose
```

## Components

### Gallery app

- [App activity](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/MainActivity.kt): `app/src/main/java/com/gal/MainActivity.kt`
- [Navigation](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/navigation/Navigation.kt): `app/src/main/java/com/gal/ui/navigation/Navigation.kt`
- [Settings](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/screens/settings/SettingsScreen.kt): `app/src/main/java/com/gal/ui/screens/settings/SettingsScreen.kt`

### Media library

- [Library screens](https://github.com/jegly/gallery/tree/main/app/src/main/java/com/gal/ui/screens): `app/src/main/java/com/gal/ui/screens`
- [Media grid](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/components/MediaGrid.kt): `app/src/main/java/com/gal/ui/components/MediaGrid.kt`
- [Media viewer](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/screens/viewer/MediaViewerScreen.kt): `app/src/main/java/com/gal/ui/screens/viewer/MediaViewerScreen.kt`
- [Intent viewer](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/screens/viewer/IntentViewerScreen.kt): `app/src/main/java/com/gal/ui/screens/viewer/IntentViewerScreen.kt`
- [Video playback](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/screens/viewer/VideoPlayer.kt): `app/src/main/java/com/gal/ui/screens/viewer/VideoPlayer.kt`
- [Media actions](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/actions/MediaActionsViewModel.kt): `app/src/main/java/com/gal/ui/actions/MediaActionsViewModel.kt`
- [Media repository](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/data/repository/MediaRepository.kt): `app/src/main/java/com/gal/data/repository/MediaRepository.kt`
- [Local media source](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/data/local/LocalDataSource.kt): `app/src/main/java/com/gal/data/local/LocalDataSource.kt`
- [Media refresh](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/data/local/MediaStoreRefresher.kt): `app/src/main/java/com/gal/data/local/MediaStoreRefresher.kt`
- [RAW formats](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/data/raw/RawFormats.kt): `app/src/main/java/com/gal/data/raw/RawFormats.kt`
- [RAW preview fetcher](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/data/raw/RawPreviewFetcher.kt): `app/src/main/java/com/gal/data/raw/RawPreviewFetcher.kt`
- [RAW preview reader](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/data/raw/RawPreviewReader.kt): `app/src/main/java/com/gal/data/raw/RawPreviewReader.kt`

### Photo editing

- [Editor activity](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/ui/screens/editor/EditActivity.kt): `app/src/main/java/com/gal/ui/screens/editor/EditActivity.kt`
- [Editor screen](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/editor/EditorScreen.kt): `app/src/main/java/com/gal/editor/EditorScreen.kt`
- [Editor view model](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/editor/EditorViewModel.kt): `app/src/main/java/com/gal/editor/EditorViewModel.kt`
- [Edit document](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/editor/EditDoc.kt): `app/src/main/java/com/gal/editor/EditDoc.kt`
- [JNI bridge](https://github.com/jegly/gallery/blob/main/app/src/main/java/com/gal/editor/GrainhouseNative.kt): `app/src/main/java/com/gal/editor/GrainhouseNative.kt`

### Grainhouse engine

- [Native editor bridge](https://github.com/jegly/gallery/blob/main/native/editor/src/lib.rs): `native/editor/src/lib.rs`
- [Edit pipeline](https://github.com/jegly/gallery/blob/main/native/grainhouse/src/pipeline.rs): `native/grainhouse/src/pipeline.rs`
- [Image adjustments](https://github.com/jegly/gallery/blob/main/native/grainhouse/src/adjust.rs): `native/grainhouse/src/adjust.rs`
- [Camera processing](https://github.com/jegly/gallery/blob/main/native/grainhouse/src/camera.rs): `native/grainhouse/src/camera.rs`
- [Image model](https://github.com/jegly/gallery/blob/main/native/grainhouse/src/img.rs): `native/grainhouse/src/img.rs`
- [Color LUTs](https://github.com/jegly/gallery/blob/main/native/grainhouse/src/lut.rs): `native/grainhouse/src/lut.rs`

### Other components

- **Gallery user**

## Connections

- Gallery user → App activity: opens
- Navigation → Library screens: routes to (evidence: `app/src/main/java/com/gal/ui/navigation/Navigation.kt`)
- Library screens → Media repository: queries media (evidence: `app/src/main/java/com/gal/ui/screens/albums/AlbumsScreen.kt`)
- Library screens → Media grid: renders (evidence: `app/src/main/java/com/gal/ui/screens/search/SearchScreen.kt`)
- Library screens → Media actions: requests actions (evidence: `app/src/main/java/com/gal/ui/screens/search/SearchScreen.kt`)
- Library screens → Media viewer: browses media
- Library screens → Intent viewer: handles shared media
- Media viewer → Video playback: plays video
- Media actions → Media repository: delegates actions (evidence: `app/src/main/java/com/gal/ui/actions/MediaActionsViewModel.kt`)
- Media repository → Local media source: reads media (evidence: `app/src/main/java/com/gal/data/repository/MediaRepository.kt`)
- App activity → Media refresh: refreshes media (evidence: `app/src/main/java/com/gal/MainActivity.kt`)
- RAW preview fetcher → RAW formats: checks formats (evidence: `app/src/main/java/com/gal/data/raw/RawPreviewFetcher.kt`)
- RAW preview fetcher → RAW preview reader: extracts preview (evidence: `app/src/main/java/com/gal/data/raw/RawPreviewFetcher.kt`)
- Editor activity → Editor screen: hosts (evidence: `app/src/main/java/com/gal/ui/screens/editor/EditActivity.kt`)
- Editor screen → Editor view model: controls (evidence: `app/src/main/java/com/gal/editor/EditorScreen.kt`)
- Editor screen → Edit document: displays (evidence: `app/src/main/java/com/gal/editor/EditorScreen.kt`)
- Editor view model → Edit document: updates (evidence: `app/src/main/java/com/gal/editor/EditorViewModel.kt`)
- Editor view model → RAW formats: checks formats (evidence: `app/src/main/java/com/gal/editor/EditorViewModel.kt`)
- Editor view model → JNI bridge: invokes (evidence: `app/src/main/java/com/gal/editor/EditorViewModel.kt`)
- JNI bridge → Native editor bridge: calls native
- Native editor bridge → Edit pipeline: runs edits
- Edit pipeline → Image adjustments: uses adjustments (evidence: `native/grainhouse/src/pipeline.rs`)
- Edit pipeline → Camera processing: uses camera tools (evidence: `native/grainhouse/src/pipeline.rs`)
- Image adjustments → Image model: processes pixels (evidence: `native/grainhouse/src/adjust.rs`)
- Image adjustments → Color LUTs: uses lookups (evidence: `native/grainhouse/src/adjust.rs`)
- Camera processing → Image model: processes pixels (evidence: `native/grainhouse/src/camera.rs`)
