# mathi2000/homeapp architecture

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

- Interactive diagram: https://gitdiagram.com/mathi2000/homeapp
- Repository: https://github.com/mathi2000/homeapp

## Overview

HOMEAPP is a small Android home-screen app. The main workflow starts at the home screen, which opens TODO, clipboard, music, video, search, or settings screens; TODO tasks are loaded and saved through Python, while other visible screens provide their own app features. The graph preserves these distinct branches and the sampled music-service relationship. Several screen implementations and Python integrations were not excerpted, so their internal connections are omitted; the README describes only the app and its basic TODO workflow.

Main entry points: [`app/src/main/java/com/homeapp/MainActivity.kt`](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/MainActivity.kt) (App entry), [`app/src/main/java/com/homeapp/util/AppLogger.kt`](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/util/AppLogger.kt) (App logger), [`app/src/main/java/com/homeapp/util/ThemeManager.kt`](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/util/ThemeManager.kt) (Theme colors), [`app/src/main/java/com/homeapp/ui/screens/MyMusicScreen.kt`](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/ui/screens/MyMusicScreen.kt) (Music library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_activity["App entry<br/>[MainActivity.kt]"]
  node_home["Home screen<br/>[HomeScreen.kt]"]
  node_settings["Settings<br/>[SettingsScreen.kt]"]
end

subgraph group_organizing["Personal organizers"]
  node_todo["TODO tasks<br/>[TodoScreen.kt]"]
  node_todo_data["TODO serialization<br/>[todo_data.py]"]
  node_clipboard["Clipboard links<br/>[ClipboardScreen.kt]"]
  node_clipboard_data["Clipboard serialization<br/>[clipboard_data.py]"]
end

subgraph group_media["Media"]
  node_music["Music library<br/>[MyMusicScreen.kt]"]
  node_player["Playback manager"]
  node_playback_service["Playback service"]
  node_video["Video library<br/>[MyVideoScreen.kt]"]
end

subgraph group_assistant["Search assistant"]
  node_search["AI search"]
  node_gemini["Gemini integration<br/>[gemini_search.py]"]
end

subgraph group_shared["Shared services"]
  node_logger["App logger<br/>[AppLogger.kt]"]
  node_theme["Theme colors<br/>[ThemeManager.kt]"]
  node_preferences[("App preferences")]
end

node_user(("User"))
node_android_services["Android services"]

node_user -->|"opens app"| node_activity
node_activity -->|"renders"| node_home
node_activity -->|"routes"| node_todo
node_activity -->|"routes"| node_clipboard
node_activity -->|"routes"| node_music
node_activity -->|"routes"| node_video
node_activity -->|"routes"| node_search
node_activity -->|"routes"| node_settings
node_home -.->|"opens"| node_settings
node_todo -->|"loads and saves"| node_todo_data
node_activity -->|"provides module"| node_todo_data
node_clipboard -.->|"uses module"| node_clipboard_data
node_activity -->|"provides module"| node_clipboard_data
node_music -.->|"controls playback"| node_player
node_player -->|"starts service"| node_playback_service
node_playback_service -->|"controls playback"| node_player
node_search -->|"requests analysis"| node_gemini
node_settings -.->|"stores settings"| node_preferences
node_activity -->|"stores theme"| node_preferences
node_todo -->|"gets colors"| node_theme
node_clipboard -->|"gets colors"| node_theme
node_search -->|"gets colors"| node_theme
node_music -->|"gets colors"| node_theme
node_video -->|"gets colors"| node_theme
node_settings -->|"uses colors"| node_theme
node_home -->|"gets colors"| node_theme
node_activity -->|"logs navigation"| node_logger
node_todo -->|"logs actions"| node_logger
node_clipboard -->|"logs actions"| node_logger
node_music -->|"logs actions"| node_logger
node_video -->|"logs actions"| node_logger
node_search -->|"logs actions"| node_logger
node_home -->|"logs actions"| node_logger
node_player -->|"logs failures"| node_logger
node_music -.->|"uses media APIs"| node_android_services
node_video -.->|"uses media APIs"| node_android_services
node_search -.->|"uses image recognition"| node_android_services

click node_activity "https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/MainActivity.kt"
click node_home "https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/ui/screens/HomeScreen.kt"
click node_settings "https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/ui/screens/SettingsScreen.kt"
click node_todo "https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/ui/screens/TodoScreen.kt"
click node_todo_data "https://github.com/mathi2000/homeapp/blob/main/app/src/main/python/todo_data.py"
click node_clipboard "https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/ui/screens/ClipboardScreen.kt"
click node_clipboard_data "https://github.com/mathi2000/homeapp/blob/main/app/src/main/python/clipboard_data.py"
click node_music "https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/ui/screens/MyMusicScreen.kt"
click node_player "https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/util/MusicPlayerManager.kt"
click node_playback_service "https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/service/MusicPlaybackService.kt"
click node_video "https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/ui/screens/MyVideoScreen.kt"
click node_search "https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/ui/screens/SearchAnythingScreen.kt"
click node_gemini "https://github.com/mathi2000/homeapp/blob/main/app/src/main/python/gemini_search.py"
click node_logger "https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/util/AppLogger.kt"
click node_theme "https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/util/ThemeManager.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_home,node_settings,node_user toneBlue
class node_todo,node_todo_data,node_clipboard,node_clipboard_data toneAmber
class node_music,node_player,node_playback_service,node_video toneMint
class node_search,node_gemini toneRose
class node_logger,node_theme,node_preferences,node_android_services toneIndigo
```

## Components

### App navigation

- [App entry](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/MainActivity.kt): `app/src/main/java/com/homeapp/MainActivity.kt`
- [Home screen](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/ui/screens/HomeScreen.kt): `app/src/main/java/com/homeapp/ui/screens/HomeScreen.kt`
- [Settings](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/ui/screens/SettingsScreen.kt): `app/src/main/java/com/homeapp/ui/screens/SettingsScreen.kt`

### Personal organizers

- [TODO tasks](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/ui/screens/TodoScreen.kt): `app/src/main/java/com/homeapp/ui/screens/TodoScreen.kt`
- [TODO serialization](https://github.com/mathi2000/homeapp/blob/main/app/src/main/python/todo_data.py): `app/src/main/python/todo_data.py`
- [Clipboard links](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/ui/screens/ClipboardScreen.kt): `app/src/main/java/com/homeapp/ui/screens/ClipboardScreen.kt`
- [Clipboard serialization](https://github.com/mathi2000/homeapp/blob/main/app/src/main/python/clipboard_data.py): `app/src/main/python/clipboard_data.py`

### Media

- [Music library](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/ui/screens/MyMusicScreen.kt): `app/src/main/java/com/homeapp/ui/screens/MyMusicScreen.kt`
- [Playback manager](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/util/MusicPlayerManager.kt): `app/src/main/java/com/homeapp/util/MusicPlayerManager.kt`
- [Playback service](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/service/MusicPlaybackService.kt): `app/src/main/java/com/homeapp/service/MusicPlaybackService.kt`
- [Video library](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/ui/screens/MyVideoScreen.kt): `app/src/main/java/com/homeapp/ui/screens/MyVideoScreen.kt`

### Search assistant

- [AI search](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/ui/screens/SearchAnythingScreen.kt): `app/src/main/java/com/homeapp/ui/screens/SearchAnythingScreen.kt`
- [Gemini integration](https://github.com/mathi2000/homeapp/blob/main/app/src/main/python/gemini_search.py): `app/src/main/python/gemini_search.py`

### Shared services

- [App logger](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/util/AppLogger.kt): `app/src/main/java/com/homeapp/util/AppLogger.kt`
- [Theme colors](https://github.com/mathi2000/homeapp/blob/main/app/src/main/java/com/homeapp/util/ThemeManager.kt): `app/src/main/java/com/homeapp/util/ThemeManager.kt`
- **App preferences**

### Other components

- **User**
- **Android services**

## Connections

- User → App entry: opens app
- App entry → Home screen: renders (evidence: `app/src/main/java/com/homeapp/MainActivity.kt`)
- App entry → TODO tasks: routes (evidence: `app/src/main/java/com/homeapp/MainActivity.kt`)
- App entry → Clipboard links: routes (evidence: `app/src/main/java/com/homeapp/MainActivity.kt`)
- App entry → Music library: routes (evidence: `app/src/main/java/com/homeapp/MainActivity.kt`)
- App entry → Video library: routes (evidence: `app/src/main/java/com/homeapp/MainActivity.kt`)
- App entry → AI search: routes (evidence: `app/src/main/java/com/homeapp/MainActivity.kt`)
- App entry → Settings: routes (evidence: `app/src/main/java/com/homeapp/MainActivity.kt`)
- Home screen → Settings: opens
- TODO tasks → TODO serialization: loads and saves (evidence: `app/src/main/java/com/homeapp/ui/screens/TodoScreen.kt`)
- App entry → TODO serialization: provides module (evidence: `app/src/main/java/com/homeapp/MainActivity.kt`)
- Clipboard links → Clipboard serialization: uses module
- App entry → Clipboard serialization: provides module (evidence: `app/src/main/java/com/homeapp/MainActivity.kt`)
- Music library → Playback manager: controls playback (evidence: `app/src/main/java/com/homeapp/ui/screens/MyMusicScreen.kt`)
- Playback manager → Playback service: starts service (evidence: `app/src/main/java/com/homeapp/util/MusicPlayerManager.kt`)
- Playback service → Playback manager: controls playback (evidence: `app/src/main/java/com/homeapp/service/MusicPlaybackService.kt`)
- AI search → Gemini integration: requests analysis (evidence: `app/src/main/java/com/homeapp/ui/screens/SearchAnythingScreen.kt`)
- Settings → App preferences: stores settings
- App entry → App preferences: stores theme (evidence: `app/src/main/java/com/homeapp/MainActivity.kt`)
- TODO tasks → Theme colors: gets colors (evidence: `app/src/main/java/com/homeapp/ui/screens/TodoScreen.kt`)
- Clipboard links → Theme colors: gets colors (evidence: `app/src/main/java/com/homeapp/ui/screens/ClipboardScreen.kt`)
- AI search → Theme colors: gets colors (evidence: `app/src/main/java/com/homeapp/ui/screens/SearchAnythingScreen.kt`)
- Music library → Theme colors: gets colors (evidence: `app/src/main/java/com/homeapp/ui/screens/MyMusicScreen.kt`)
- Video library → Theme colors: gets colors (evidence: `app/src/main/java/com/homeapp/ui/screens/MyVideoScreen.kt`)
- Settings → Theme colors: uses colors (evidence: `app/src/main/java/com/homeapp/ui/screens/SettingsScreen.kt`)
- Home screen → Theme colors: gets colors (evidence: `app/src/main/java/com/homeapp/ui/screens/HomeScreen.kt`)
- App entry → App logger: logs navigation (evidence: `app/src/main/java/com/homeapp/MainActivity.kt`)
- TODO tasks → App logger: logs actions (evidence: `app/src/main/java/com/homeapp/ui/screens/TodoScreen.kt`)
- Clipboard links → App logger: logs actions (evidence: `app/src/main/java/com/homeapp/ui/screens/ClipboardScreen.kt`)
- Music library → App logger: logs actions (evidence: `app/src/main/java/com/homeapp/ui/screens/MyMusicScreen.kt`)
- Video library → App logger: logs actions (evidence: `app/src/main/java/com/homeapp/ui/screens/MyVideoScreen.kt`)
- AI search → App logger: logs actions (evidence: `app/src/main/java/com/homeapp/ui/screens/SearchAnythingScreen.kt`)
- Home screen → App logger: logs actions (evidence: `app/src/main/java/com/homeapp/ui/screens/HomeScreen.kt`)
- Playback manager → App logger: logs failures (evidence: `app/src/main/java/com/homeapp/util/MusicPlayerManager.kt`)
- Music library → Android services: uses media APIs
- Video library → Android services: uses media APIs
- AI search → Android services: uses image recognition
