# yuliskov/smarttubelegacy architecture

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

- Interactive diagram: https://gitdiagram.com/yuliskov/smarttubelegacy
- Repository: https://github.com/yuliskov/smarttubelegacy

## Overview

SmartYouTubeTV is an Android TV YouTube client whose main journey is remote- or intent-driven navigation into video playback. The README documents WebView and Crosswalk browser choices, ExoPlayer playback, resolution/codec selection, login, and TV-oriented controls. The graph preserves those product branches and the sampled browser, player, preferences, and key-handling layers. Several domain relationships are documented rather than visible in sampled implementation; those links are dashed or cited to the README, and unsampled details are not inferred.

Main entry points: [`exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/ExoPlayerFragment.java`](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/ExoPlayerFragment.java) (ExoPlayer), [`smartyoutubetv/src/main/java/com/liskovsoft/smartyoutubetv/flavors/common/FragmentManagerActivity.java`](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/smartyoutubetv/src/main/java/com/liskovsoft/smartyoutubetv/flavors/common/FragmentManagerActivity.java) (Activity host), [`browser/src/main/java/com/liskovsoft/browser/Controller.java`](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/browser/src/main/java/com/liskovsoft/browser/Controller.java) (Browser controller), [`smartyoutubetv/src/main/java/com/liskovsoft/smartyoutubetv/flavors/common/TwoFragmentsManagerActivity.java`](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/smartyoutubetv/src/main/java/com/liskovsoft/smartyoutubetv/flavors/common/TwoFragmentsManagerActivity.java) (Browser/player host)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App coordination"]
  node_activity["Activity host"]
  node_fragment_manager["Fragment coordination"]
  node_two_fragments["Browser/player host"]
end

subgraph group_browser["Browsing"]
  node_browser["Browser app<br/>[Browser.java]"]
  node_browser_controller["Browser controller<br/>[Controller.java]"]
  node_tabs["Tabs<br/>[TabControl.java]"]
  node_tab["Web tab<br/>[Tab.java]"]
  node_browser_settings["Browser settings"]
  node_search["Search engines<br/>[SearchEngine.java]"]
  node_browser_engine["WebView / XWalk"]
end

subgraph group_playback["Playback"]
  node_player["ExoPlayer"]
  node_player_core["Player lifecycle"]
  node_player_controls["Player controls"]
  node_track_selection["Track selection"]
  node_frame_rate["Frame-rate sync"]
end

subgraph group_shared["Shared services"]
  node_preferences[("App preferences")]
  node_global_keys["Remote key handling"]
  node_application["Application services"]
  node_uri["URI processing<br/>[Uri.java]"]
  node_playlist["M3U parsing<br/>[M3UParser.java]"]
end

node_viewer(("TV viewer"))

node_viewer -.->|"interacts with"| node_activity
node_activity -->|"dispatches keys"| node_global_keys
node_activity -.->|"hosts browser/player"| node_two_fragments
node_two_fragments -->|"initializes"| node_player
node_two_fragments -->|"selects engine"| node_browser
node_activity -->|"implements coordination"| node_fragment_manager
node_browser -->|"initializes"| node_browser_settings
node_browser_controller -->|"manages tabs"| node_tabs
node_browser_controller -->|"uses settings"| node_browser_settings
node_tabs -.->|"manages"| node_tab
node_browser_controller -.->|"creates web view"| node_browser_engine
node_viewer -.->|"submits query"| node_search
node_player -.->|"uses lifecycle"| node_player_core
node_player -.->|"updates controls"| node_player_controls
node_player -.->|"selects tracks"| node_track_selection
node_player -->|"syncs display"| node_frame_rate
node_application -->|"initializes"| node_preferences
node_global_keys -->|"routes shortcut"| node_fragment_manager
node_player -.->|"uses URI utilities"| node_uri
node_playlist -.->|"parses URI data"| node_uri
node_viewer -.->|"chooses playback mode"| node_browser_engine
node_viewer -.->|"starts video playback"| node_player
node_viewer -.->|"sets resolution/codec"| node_preferences

click node_activity "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/smartyoutubetv/src/main/java/com/liskovsoft/smartyoutubetv/flavors/common/FragmentManagerActivity.java"
click node_fragment_manager "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/common/src/main/java/com/liskovsoft/smartyoutubetv/fragments/FragmentManager.java"
click node_two_fragments "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/smartyoutubetv/src/main/java/com/liskovsoft/smartyoutubetv/flavors/common/TwoFragmentsManagerActivity.java"
click node_browser "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/browser/src/main/java/com/liskovsoft/browser/Browser.java"
click node_browser_controller "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/browser/src/main/java/com/liskovsoft/browser/Controller.java"
click node_tabs "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/browser/src/main/java/com/liskovsoft/browser/TabControl.java"
click node_tab "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/browser/src/main/java/com/liskovsoft/browser/Tab.java"
click node_browser_settings "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/browser/src/main/java/com/liskovsoft/browser/BrowserSettings.java"
click node_search "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/browser/src/main/java/com/liskovsoft/browser/search/SearchEngine.java"
click node_browser_engine "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/browser/src/main/java/com/liskovsoft/browser/BrowserWebViewFactory.java"
click node_player "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/ExoPlayerFragment.java"
click node_player_core "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/ExoPlayerBaseFragment.java"
click node_player_controls "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/support/PlayerButtonsManager.java"
click node_track_selection "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/common/state/TrackSelectionManager.java"
click node_frame_rate "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/autoframerate/AutoFrameRateManager.java"
click node_preferences "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/common/src/main/java/com/liskovsoft/smartyoutubetv/prefs/SmartPreferences.java"
click node_global_keys "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/common/src/main/java/com/liskovsoft/smartyoutubetv/misc/keyhandler/GlobalKeyHandler.java"
click node_application "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/common/src/main/java/com/liskovsoft/smartyoutubetv/CommonApplication.java"
click node_uri "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/common/src/main/java/com/liskovsoft/m3uparser/core/uri/Uri.java"
click node_playlist "https://github.com/yuliskov/smarttubelegacy/blob/main-branch/common/src/main/java/com/liskovsoft/m3uparser/m3u/M3UParser.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_activity,node_fragment_manager,node_two_fragments,node_viewer toneBlue
class node_browser,node_browser_controller,node_tabs,node_tab,node_browser_settings,node_search,node_browser_engine toneAmber
class node_player,node_player_core,node_player_controls,node_track_selection,node_frame_rate toneMint
class node_preferences,node_global_keys,node_application,node_uri,node_playlist toneRose
```

## Components

### App coordination

- [Activity host](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/smartyoutubetv/src/main/java/com/liskovsoft/smartyoutubetv/flavors/common/FragmentManagerActivity.java): `smartyoutubetv/src/main/java/com/liskovsoft/smartyoutubetv/flavors/common/FragmentManagerActivity.java`
- [Fragment coordination](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/common/src/main/java/com/liskovsoft/smartyoutubetv/fragments/FragmentManager.java): `common/src/main/java/com/liskovsoft/smartyoutubetv/fragments/FragmentManager.java`
- [Browser/player host](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/smartyoutubetv/src/main/java/com/liskovsoft/smartyoutubetv/flavors/common/TwoFragmentsManagerActivity.java): `smartyoutubetv/src/main/java/com/liskovsoft/smartyoutubetv/flavors/common/TwoFragmentsManagerActivity.java`

### Browsing

- [Browser app](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/browser/src/main/java/com/liskovsoft/browser/Browser.java): `browser/src/main/java/com/liskovsoft/browser/Browser.java`
- [Browser controller](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/browser/src/main/java/com/liskovsoft/browser/Controller.java): `browser/src/main/java/com/liskovsoft/browser/Controller.java`
- [Tabs](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/browser/src/main/java/com/liskovsoft/browser/TabControl.java): `browser/src/main/java/com/liskovsoft/browser/TabControl.java`
- [Web tab](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/browser/src/main/java/com/liskovsoft/browser/Tab.java): `browser/src/main/java/com/liskovsoft/browser/Tab.java`
- [Browser settings](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/browser/src/main/java/com/liskovsoft/browser/BrowserSettings.java): `browser/src/main/java/com/liskovsoft/browser/BrowserSettings.java`
- [Search engines](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/browser/src/main/java/com/liskovsoft/browser/search/SearchEngine.java): `browser/src/main/java/com/liskovsoft/browser/search/SearchEngine.java`
- [WebView / XWalk](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/browser/src/main/java/com/liskovsoft/browser/BrowserWebViewFactory.java): `browser/src/main/java/com/liskovsoft/browser/BrowserWebViewFactory.java`

### Playback

- [ExoPlayer](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/ExoPlayerFragment.java): `exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/ExoPlayerFragment.java`
- [Player lifecycle](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/ExoPlayerBaseFragment.java): `exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/ExoPlayerBaseFragment.java`
- [Player controls](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/support/PlayerButtonsManager.java): `exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/support/PlayerButtonsManager.java`
- [Track selection](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/common/state/TrackSelectionManager.java): `exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/common/state/TrackSelectionManager.java`
- [Frame-rate sync](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/autoframerate/AutoFrameRateManager.java): `exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/autoframerate/AutoFrameRateManager.java`

### Shared services

- [App preferences](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/common/src/main/java/com/liskovsoft/smartyoutubetv/prefs/SmartPreferences.java): `common/src/main/java/com/liskovsoft/smartyoutubetv/prefs/SmartPreferences.java`
- [Remote key handling](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/common/src/main/java/com/liskovsoft/smartyoutubetv/misc/keyhandler/GlobalKeyHandler.java): `common/src/main/java/com/liskovsoft/smartyoutubetv/misc/keyhandler/GlobalKeyHandler.java`
- [Application services](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/common/src/main/java/com/liskovsoft/smartyoutubetv/CommonApplication.java): `common/src/main/java/com/liskovsoft/smartyoutubetv/CommonApplication.java`
- [URI processing](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/common/src/main/java/com/liskovsoft/m3uparser/core/uri/Uri.java): `common/src/main/java/com/liskovsoft/m3uparser/core/uri/Uri.java`
- [M3U parsing](https://github.com/yuliskov/smarttubelegacy/blob/main-branch/common/src/main/java/com/liskovsoft/m3uparser/m3u/M3UParser.java): `common/src/main/java/com/liskovsoft/m3uparser/m3u/M3UParser.java`

### Other components

- **TV viewer**

## Connections

- TV viewer → Activity host: interacts with
- Activity host → Remote key handling: dispatches keys (evidence: `smartyoutubetv/src/main/java/com/liskovsoft/smartyoutubetv/flavors/common/FragmentManagerActivity.java`)
- Activity host → Browser/player host: hosts browser/player (evidence: `smartyoutubetv/src/main/java/com/liskovsoft/smartyoutubetv/flavors/common/TwoFragmentsManagerActivity.java`)
- Browser/player host → ExoPlayer: initializes (evidence: `smartyoutubetv/src/main/java/com/liskovsoft/smartyoutubetv/flavors/common/TwoFragmentsManagerActivity.java`)
- Browser/player host → Browser app: selects engine (evidence: `smartyoutubetv/src/main/java/com/liskovsoft/smartyoutubetv/flavors/common/TwoFragmentsManagerActivity.java`)
- Activity host → Fragment coordination: implements coordination (evidence: `smartyoutubetv/src/main/java/com/liskovsoft/smartyoutubetv/flavors/common/FragmentManagerActivity.java`)
- Browser app → Browser settings: initializes (evidence: `browser/src/main/java/com/liskovsoft/browser/Browser.java`)
- Browser controller → Tabs: manages tabs (evidence: `browser/src/main/java/com/liskovsoft/browser/Controller.java`)
- Browser controller → Browser settings: uses settings (evidence: `browser/src/main/java/com/liskovsoft/browser/Controller.java`)
- Tabs → Web tab: manages (evidence: `browser/src/main/java/com/liskovsoft/browser/Tab.java`)
- Browser controller → WebView / XWalk: creates web view (evidence: `browser/src/main/java/com/liskovsoft/browser/Controller.java`)
- TV viewer → Search engines: submits query
- ExoPlayer → Player lifecycle: uses lifecycle (evidence: `exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/ExoPlayerFragment.java`)
- ExoPlayer → Player controls: updates controls (evidence: `exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/support/PlayerButtonsManager.java`)
- ExoPlayer → Track selection: selects tracks
- ExoPlayer → Frame-rate sync: syncs display (evidence: `exoplayeractivity/src/main/java/com/liskovsoft/smartyoutubetv/flavors/exoplayer/player/autoframerate/AutoFrameRateManager.java`)
- Application services → App preferences: initializes (evidence: `common/src/main/java/com/liskovsoft/smartyoutubetv/CommonApplication.java`)
- Remote key handling → Fragment coordination: routes shortcut (evidence: `common/src/main/java/com/liskovsoft/smartyoutubetv/misc/keyhandler/GlobalKeyHandler.java`)
- ExoPlayer → URI processing: uses URI utilities
- M3U parsing → URI processing: parses URI data
- TV viewer → WebView / XWalk: chooses playback mode (evidence: `README.md`)
- TV viewer → ExoPlayer: starts video playback (evidence: `README.md`)
- TV viewer → App preferences: sets resolution/codec (evidence: `README.md`)
