# vijayy999/meme_engine architecture

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

- Interactive diagram: https://gitdiagram.com/vijayy999/meme_engine
- Repository: https://github.com/vijayy999/meme_engine

## Overview

Meme Engine is a local Android meme organizer and system picker. Users select folders, scan and tag source images, search or filter them, and copy tagged images into destination storage; third-party apps and Android’s document picker can also access tagged memes. The README documents the broader tagging, picker, Documents Provider, and OTA capabilities, while the sampled activity excerpt supports only some runtime calls. Dashed edges mark documented flows whose implementation was not sampled.

Main entry points: [`MainGridActivity.java`](https://github.com/vijayy999/meme_engine/blob/main/MainGridActivity.java) (Main dashboard), [`app/src/main/java/com/example/meme_engine/ui/SearchActivity.java`](https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/ui/SearchActivity.java) (Search and picker UI), [`app/src/main/java/com/example/meme_engine/data/MemeDatabase.java`](https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/data/MemeDatabase.java) (Room database), [`app/src/main/java/com/example/meme_engine/ui/TagMemeDialogFragment.java`](https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/ui/TagMemeDialogFragment.java) (Tagging dialog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App workflow"]
  node_main["Main dashboard"]
  node_search["Search and picker UI"]
  node_tagging["Tagging dialog"]
  node_source_grid["Source grid<br/>[MemeAdapter.java]"]
  node_destination_grid["Destination grid"]
end

subgraph group_storage["Meme data"]
  node_scanner["Folder scanner<br/>[MemeScanner.java]"]
  node_storage_helper["Folder permissions<br/>[StorageHelper.java]"]
  node_file_util["File operations<br/>[FileUtil.java]"]
  node_meme_record["Meme metadata<br/>[Meme.java]"]
  node_dao["Meme queries<br/>[MemeDao.java]"]
  node_database[("Room database<br/>[MemeDatabase.java]")]
end

subgraph group_system["Android integration"]
  node_documents["Documents provider"]
end

subgraph group_updates["Software updates"]
  node_updates_manager["OTA updates<br/>[UpdateManager.java]"]
  node_release_service["Release service"]
end

node_user(("User"))
node_external_app["Third-party app"]
node_android_picker["Android picker"]

node_user -->|"uses"| node_main
node_main -->|"launches picker"| node_search
node_main -->|"loads folders"| node_storage_helper
node_main -->|"scans source"| node_scanner
node_main -->|"updates grid"| node_source_grid
node_main -->|"updates grid"| node_destination_grid
node_source_grid -.->|"opens tagging"| node_tagging
node_tagging -->|"returns tags"| node_main
node_main -->|"queries and saves"| node_database
node_database -.->|"provides queries"| node_dao
node_dao -.->|"stores records"| node_meme_record
node_main -->|"deletes files"| node_file_util
node_main -.->|"copies tagged files"| node_file_util
node_search -.->|"searches tags"| node_database
node_android_picker -.->|"requests meme"| node_search
node_search -.->|"returns selection"| node_external_app
node_android_picker -.->|"browses documents"| node_documents
node_documents -.->|"exposes tagged memes"| node_database
node_user -.->|"checks updates"| node_updates_manager
node_updates_manager -.->|"checks releases"| node_release_service

click node_main "https://github.com/vijayy999/meme_engine/blob/main/MainGridActivity.java"
click node_search "https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/ui/SearchActivity.java"
click node_tagging "https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/ui/TagMemeDialogFragment.java"
click node_source_grid "https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/ui/MemeAdapter.java"
click node_destination_grid "https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/ui/DestinationAdapter.java"
click node_scanner "https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/util/MemeScanner.java"
click node_storage_helper "https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/util/StorageHelper.java"
click node_file_util "https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/util/FileUtil.java"
click node_meme_record "https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/data/Meme.java"
click node_dao "https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/data/MemeDao.java"
click node_database "https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/data/MemeDatabase.java"
click node_documents "https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/provider/MemeDocumentsProvider.java"
click node_updates_manager "https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/util/UpdateManager.java"

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_main,node_search,node_tagging,node_source_grid,node_destination_grid,node_user toneBlue
class node_scanner,node_storage_helper,node_file_util,node_meme_record,node_dao,node_database toneAmber
class node_documents toneMint
class node_updates_manager,node_release_service toneRose
class node_external_app,node_android_picker toneIndigo
```

## Components

### App workflow

- [Main dashboard](https://github.com/vijayy999/meme_engine/blob/main/MainGridActivity.java): `MainGridActivity.java`
- [Search and picker UI](https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/ui/SearchActivity.java): `app/src/main/java/com/example/meme_engine/ui/SearchActivity.java`
- [Tagging dialog](https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/ui/TagMemeDialogFragment.java): `app/src/main/java/com/example/meme_engine/ui/TagMemeDialogFragment.java`
- [Source grid](https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/ui/MemeAdapter.java): `app/src/main/java/com/example/meme_engine/ui/MemeAdapter.java`
- [Destination grid](https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/ui/DestinationAdapter.java): `app/src/main/java/com/example/meme_engine/ui/DestinationAdapter.java`

### Meme data

- [Folder scanner](https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/util/MemeScanner.java): `app/src/main/java/com/example/meme_engine/util/MemeScanner.java`
- [Folder permissions](https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/util/StorageHelper.java): `app/src/main/java/com/example/meme_engine/util/StorageHelper.java`
- [File operations](https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/util/FileUtil.java): `app/src/main/java/com/example/meme_engine/util/FileUtil.java`
- [Meme metadata](https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/data/Meme.java): `app/src/main/java/com/example/meme_engine/data/Meme.java`
- [Meme queries](https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/data/MemeDao.java): `app/src/main/java/com/example/meme_engine/data/MemeDao.java`
- [Room database](https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/data/MemeDatabase.java): `app/src/main/java/com/example/meme_engine/data/MemeDatabase.java`

### Android integration

- [Documents provider](https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/provider/MemeDocumentsProvider.java): `app/src/main/java/com/example/meme_engine/provider/MemeDocumentsProvider.java`

### Software updates

- [OTA updates](https://github.com/vijayy999/meme_engine/blob/main/app/src/main/java/com/example/meme_engine/util/UpdateManager.java): `app/src/main/java/com/example/meme_engine/util/UpdateManager.java`
- **Release service**

### Other components

- **User**
- **Third-party app**
- **Android picker**

## Connections

- User → Main dashboard: uses (evidence: `README.md`)
- Main dashboard → Search and picker UI: launches picker (evidence: `MainGridActivity.java`)
- Main dashboard → Folder permissions: loads folders (evidence: `MainGridActivity.java`)
- Main dashboard → Folder scanner: scans source (evidence: `README.md`)
- Main dashboard → Source grid: updates grid (evidence: `MainGridActivity.java`)
- Main dashboard → Destination grid: updates grid (evidence: `MainGridActivity.java`)
- Source grid → Tagging dialog: opens tagging (evidence: `README.md`)
- Tagging dialog → Main dashboard: returns tags (evidence: `MainGridActivity.java`)
- Main dashboard → Room database: queries and saves (evidence: `MainGridActivity.java`)
- Room database → Meme queries: provides queries (evidence: `README.md`)
- Meme queries → Meme metadata: stores records (evidence: `README.md`)
- Main dashboard → File operations: deletes files (evidence: `MainGridActivity.java`)
- Main dashboard → File operations: copies tagged files (evidence: `README.md`)
- Search and picker UI → Room database: searches tags (evidence: `README.md`)
- Android picker → Search and picker UI: requests meme (evidence: `README.md`)
- Search and picker UI → Third-party app: returns selection (evidence: `README.md`)
- Android picker → Documents provider: browses documents (evidence: `README.md`)
- Documents provider → Room database: exposes tagged memes (evidence: `README.md`)
- User → OTA updates: checks updates (evidence: `README.md`)
- OTA updates → Release service: checks releases (evidence: `README.md`)
