# revidm/gdrive_gallery_view_assist architecture

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

- Interactive diagram: https://gitdiagram.com/revidm/gdrive_gallery_view_assist
- Repository: https://github.com/revidm/gdrive_gallery_view_assist

## Overview

This Home Assistant add-on serves images from a configured Google Drive folder as a slideshow for View Assist. The main request flow selects an image, fetches or reuses its bytes, optionally resizes it, and returns it from an image endpoint; a health endpoint reports store status. Configuration also enables filtering, recursive/shared-drive listing, shuffle modes, caching, and prefetch. The graph follows the sampled runtime code and README; it does not include the separate OAuth setup helper.

Main entry points: [`gdrive_gallery_view_assist/app/server.py`](https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/server.py) (HTTP endpoints), [`gdrive_gallery_view_assist/app/store.py`](https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/store.py) (Item store), [`gdrive_gallery_view_assist/app/google_drive.py`](https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/google_drive.py) (Drive client), [`gdrive_gallery_view_assist/app/config.py`](https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/config.py) (Settings loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["HTTP service"]
  node_server["HTTP endpoints<br/>[server.py]"]
  node_settings["Settings loader<br/>[config.py]"]
end

subgraph group_catalog["Image selection"]
  node_store["Item store<br/>[store.py]"]
  node_selection["Item selection<br/>[store.py]"]
  node_drive_cache[("Drive item cache<br/>[store.py]")]
end

subgraph group_delivery["Image delivery"]
  node_image_cache[("Image cache<br/>[store.py]")]
  node_image_transform["Resize profiles<br/>[store.py]"]
end

subgraph group_integration["Google Drive access"]
  node_drive_client["Drive client<br/>[google_drive.py]"]
end

node_view_assist(("View Assist"))
node_google_drive_api["Google Drive API"]
node_google_oauth["Google OAuth"]

node_view_assist -->|"requests slideshow"| node_server
node_server -->|"loads settings"| node_settings
node_server -->|"constructs and queries"| node_store
node_server -->|"requests next item"| node_selection
node_server -->|"requests image"| node_image_cache
node_server -->|"resolves profile"| node_image_transform
node_server -->|"reads status"| node_store
node_store -->|"refreshes and reads"| node_drive_cache
node_store -->|"lists and downloads"| node_drive_client
node_store -->|"selects and filters"| node_selection
node_store -->|"caches and evicts"| node_image_cache
node_store -->|"resizes images"| node_image_transform
node_drive_client -->|"refreshes access token"| node_google_oauth
node_drive_client -->|"lists and downloads files"| node_google_drive_api

click node_server "https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/server.py"
click node_settings "https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/config.py"
click node_store "https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/store.py"
click node_selection "https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/store.py"
click node_drive_cache "https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/store.py"
click node_image_cache "https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/store.py"
click node_image_transform "https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/store.py"
click node_drive_client "https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/google_drive.py"

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_server,node_settings,node_view_assist toneBlue
class node_store,node_selection,node_drive_cache toneAmber
class node_image_cache,node_image_transform,node_google_drive_api toneMint
class node_drive_client toneRose
class node_google_oauth toneIndigo
```

## Components

### HTTP service

- [HTTP endpoints](https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/server.py): `gdrive_gallery_view_assist/app/server.py`
- [Settings loader](https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/config.py): `gdrive_gallery_view_assist/app/config.py`

### Image selection

- [Item store](https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/store.py): `gdrive_gallery_view_assist/app/store.py`
- [Item selection](https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/store.py): `gdrive_gallery_view_assist/app/store.py`
- [Drive item cache](https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/store.py): `gdrive_gallery_view_assist/app/store.py`

### Image delivery

- [Image cache](https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/store.py): `gdrive_gallery_view_assist/app/store.py`
- [Resize profiles](https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/store.py): `gdrive_gallery_view_assist/app/store.py`

### Google Drive access

- [Drive client](https://github.com/revidm/gdrive_gallery_view_assist/blob/main/gdrive_gallery_view_assist/app/google_drive.py): `gdrive_gallery_view_assist/app/google_drive.py`

### Other components

- **View Assist**
- **Google Drive API**
- **Google OAuth**

## Connections

- View Assist → HTTP endpoints: requests slideshow (evidence: `README.md`)
- HTTP endpoints → Settings loader: loads settings (evidence: `gdrive_gallery_view_assist/app/server.py`)
- HTTP endpoints → Item store: constructs and queries (evidence: `gdrive_gallery_view_assist/app/server.py`)
- HTTP endpoints → Item selection: requests next item (evidence: `gdrive_gallery_view_assist/app/server.py`)
- HTTP endpoints → Image cache: requests image (evidence: `gdrive_gallery_view_assist/app/server.py`)
- HTTP endpoints → Resize profiles: resolves profile (evidence: `gdrive_gallery_view_assist/app/server.py`)
- HTTP endpoints → Item store: reads status (evidence: `gdrive_gallery_view_assist/app/server.py`)
- Item store → Drive item cache: refreshes and reads (evidence: `gdrive_gallery_view_assist/app/store.py`)
- Item store → Drive client: lists and downloads (evidence: `gdrive_gallery_view_assist/app/store.py`)
- Item store → Item selection: selects and filters (evidence: `gdrive_gallery_view_assist/app/store.py`)
- Item store → Image cache: caches and evicts (evidence: `gdrive_gallery_view_assist/app/store.py`)
- Item store → Resize profiles: resizes images (evidence: `gdrive_gallery_view_assist/app/store.py`)
- Drive client → Google OAuth: refreshes access token (evidence: `gdrive_gallery_view_assist/app/google_drive.py`)
- Drive client → Google Drive API: lists and downloads files (evidence: `gdrive_gallery_view_assist/app/google_drive.py`)
