# thekirankumar/carstream-android-auto architecture

> Architecture diagram of the GitHub repository thekirankumar/carstream-android-auto, 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/thekirankumar/carstream-android-auto
- Repository: https://github.com/thekirankumar/carstream-android-auto

## Overview

This is an Android Auto YouTube player, with a companion phone UI. The principal car workflow starts in the car activity, which hosts the car browsing fragment; the app also has bookmark browsing and a native ExoPlayer path. A media-browser service exposes playback controls and metadata. The README confirms the Android Auto YouTube-player purpose, but sampled excerpts do not expose enough wiring to trace search, voice input, settings, or all playback handoffs, so those links are omitted.

Main entry points: [`app/src/main/java/com/thekirankumar/youtubeauto/activity/MainCarActivity.java`](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/activity/MainCarActivity.java) (Car activity), [`app/src/main/java/com/thekirankumar/youtubeauto/bookmarks/BookmarksFragment.java`](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/bookmarks/BookmarksFragment.java) (Bookmarks screen), [`app/src/main/java/com/thekirankumar/youtubeauto/fragments/CarFragment.java`](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/fragments/CarFragment.java) (Car fragment), [`app/src/main/java/com/thekirankumar/youtubeauto/fragments/WebViewCarFragment.java`](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/fragments/WebViewCarFragment.java) (Car browser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["App interfaces"]
  node_car_activity["Car activity"]
  node_car_fragment["Car fragment<br/>[CarFragment.java]"]
  node_phone_activity["Phone activity"]
  node_settings["Phone settings"]
  node_settings_utils["Settings preferences<br/>[SettingsUtils.java]"]
end

subgraph group_browse["Web browsing"]
  node_car_browser["Car browser"]
  node_phone_browser["Phone browser"]
  node_webview["Video WebView"]
  node_video_webview["Video controls<br/>[VideoWebView.java]"]
  node_chrome_client["Video fullscreen"]
end

subgraph group_playback["Playback"]
  node_native_player["Native player"]
  node_player_queue["Player queue<br/>[PlayerQueue.java]"]
  node_media_service["Media browser service"]
  node_ui_broadcast["UI broadcasts"]
end

subgraph group_saved["Bookmarks"]
  node_bookmarks["Bookmarks screen"]
  node_bookmark_model[("Bookmark record<br/>[Bookmark.java]")]
  node_bookmark_adapter["Bookmark list"]
end

node_driver(("Driver"))

node_car_activity -->|"hosts initially"| node_car_browser
node_car_activity -->|"attaches fragment"| node_car_fragment
node_bookmarks -->|"loads records"| node_bookmark_model
node_bookmarks -->|"updates list"| node_bookmark_adapter

click node_car_activity "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/activity/MainCarActivity.java"
click node_car_fragment "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/fragments/CarFragment.java"
click node_phone_activity "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/activity/MainPhoneActivity.java"
click node_settings "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/activity/SettingsPhoneActivity.java"
click node_car_browser "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/fragments/WebViewCarFragment.java"
click node_phone_browser "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/fragments/WebViewPhoneFragment.java"
click node_webview "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/webview/VideoEnabledWebView.java"
click node_video_webview "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/webview/VideoWebView.java"
click node_chrome_client "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/webview/VideoEnabledWebChromeClient.java"
click node_bookmarks "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/bookmarks/BookmarksFragment.java"
click node_bookmark_model "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/bookmarks/Bookmark.java"
click node_bookmark_adapter "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/bookmarks/BookmarksAdapter.java"
click node_native_player "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/exoplayer/ExoPlayerFragment.java"
click node_player_queue "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/exoplayer/PlayerQueue.java"
click node_media_service "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/angry/unb10ck3d_y0utub3_andro1d_aut0/service/MyMediaBrowserService.java"
click node_ui_broadcast "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/utils/BroadcastFromUI.java"
click node_settings_utils "https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/utils/SettingsUtils.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_car_activity,node_car_fragment,node_phone_activity,node_settings,node_settings_utils toneBlue
class node_car_browser,node_phone_browser,node_webview,node_video_webview,node_chrome_client toneAmber
class node_native_player,node_player_queue,node_media_service,node_ui_broadcast toneMint
class node_bookmarks,node_bookmark_model,node_bookmark_adapter toneRose
class node_driver toneIndigo
```

## Components

### App interfaces

- [Car activity](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/activity/MainCarActivity.java): `app/src/main/java/com/thekirankumar/youtubeauto/activity/MainCarActivity.java`
- [Car fragment](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/fragments/CarFragment.java): `app/src/main/java/com/thekirankumar/youtubeauto/fragments/CarFragment.java`
- [Phone activity](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/activity/MainPhoneActivity.java): `app/src/main/java/com/thekirankumar/youtubeauto/activity/MainPhoneActivity.java`
- [Phone settings](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/activity/SettingsPhoneActivity.java): `app/src/main/java/com/thekirankumar/youtubeauto/activity/SettingsPhoneActivity.java`
- [Settings preferences](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/utils/SettingsUtils.java): `app/src/main/java/com/thekirankumar/youtubeauto/utils/SettingsUtils.java`

### Web browsing

- [Car browser](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/fragments/WebViewCarFragment.java): `app/src/main/java/com/thekirankumar/youtubeauto/fragments/WebViewCarFragment.java`
- [Phone browser](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/fragments/WebViewPhoneFragment.java): `app/src/main/java/com/thekirankumar/youtubeauto/fragments/WebViewPhoneFragment.java`
- [Video WebView](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/webview/VideoEnabledWebView.java): `app/src/main/java/com/thekirankumar/youtubeauto/webview/VideoEnabledWebView.java`
- [Video controls](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/webview/VideoWebView.java): `app/src/main/java/com/thekirankumar/youtubeauto/webview/VideoWebView.java`
- [Video fullscreen](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/webview/VideoEnabledWebChromeClient.java): `app/src/main/java/com/thekirankumar/youtubeauto/webview/VideoEnabledWebChromeClient.java`

### Playback

- [Native player](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/exoplayer/ExoPlayerFragment.java): `app/src/main/java/com/thekirankumar/youtubeauto/exoplayer/ExoPlayerFragment.java`
- [Player queue](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/exoplayer/PlayerQueue.java): `app/src/main/java/com/thekirankumar/youtubeauto/exoplayer/PlayerQueue.java`
- [Media browser service](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/angry/unb10ck3d_y0utub3_andro1d_aut0/service/MyMediaBrowserService.java): `app/src/main/java/com/angry/unb10ck3d_y0utub3_andro1d_aut0/service/MyMediaBrowserService.java`
- [UI broadcasts](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/utils/BroadcastFromUI.java): `app/src/main/java/com/thekirankumar/youtubeauto/utils/BroadcastFromUI.java`

### Bookmarks

- [Bookmarks screen](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/bookmarks/BookmarksFragment.java): `app/src/main/java/com/thekirankumar/youtubeauto/bookmarks/BookmarksFragment.java`
- [Bookmark record](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/bookmarks/Bookmark.java): `app/src/main/java/com/thekirankumar/youtubeauto/bookmarks/Bookmark.java`
- [Bookmark list](https://github.com/thekirankumar/carstream-android-auto/blob/master/app/src/main/java/com/thekirankumar/youtubeauto/bookmarks/BookmarksAdapter.java): `app/src/main/java/com/thekirankumar/youtubeauto/bookmarks/BookmarksAdapter.java`

### Other components

- **Driver**

## Connections

- Car activity → Car browser: hosts initially (evidence: `app/src/main/java/com/thekirankumar/youtubeauto/activity/MainCarActivity.java`)
- Car activity → Car fragment: attaches fragment (evidence: `app/src/main/java/com/thekirankumar/youtubeauto/activity/MainCarActivity.java`)
- Bookmarks screen → Bookmark record: loads records (evidence: `app/src/main/java/com/thekirankumar/youtubeauto/bookmarks/BookmarksFragment.java`)
- Bookmarks screen → Bookmark list: updates list (evidence: `app/src/main/java/com/thekirankumar/youtubeauto/bookmarks/BookmarksFragment.java`)
