# aleixrodriala/newtube architecture

> Architecture diagram of the GitHub repository aleixrodriala/newtube, 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/aleixrodriala/newtube
- Repository: https://github.com/aleixrodriala/newtube

## Overview

NewTube is an Android phone and tablet YouTube client built on SmartTube’s media-service engine. Users browse or search for videos, open one in the app’s player, and can sign in to load account-based content; the app also supports offline downloads and casting. Playback includes background controls and configurable tracks, while SponsorBlock, DeArrow, and dislike estimates are documented capabilities. The graph combines README-documented behavior with the supplied source excerpts and index; unsampled subsystem links are omitted where their callers were not shown.

Main entry points: [`common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/PlaybackPresenter.java`](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/PlaybackPresenter.java) (Playback presenter), [`smarttubetv/src/stmobile/java/com/newtube/mobile/downloads/MobileDownloadService.java`](https://github.com/aleixrodriala/newtube/blob/main/smarttubetv/src/stmobile/java/com/newtube/mobile/downloads/MobileDownloadService.java) (Offline downloads), [`common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/BrowsePresenter.java`](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/BrowsePresenter.java) (Browse and search), [`common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/DetailsPresenter.java`](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/DetailsPresenter.java) (Video details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_browse["Browse and search"]
  node_search["Search"]
  node_details["Video details"]
  node_navigation["View navigation<br/>[ViewManager.java]"]
end

subgraph group_media["Playback and media"]
  node_playback["Playback presenter"]
  node_playback_view["Playback view<br/>[PlaybackView.java]"]
  node_player_engine["Player engine<br/>[PlayerEngine.java]"]
  node_tracks["Track selection"]
  node_video["Video model<br/>[Video.java]"]
  node_playback_state[("Playback history")]
  node_media_service["YouTube media engine"]
end

subgraph group_account["Account and preferences"]
  node_signin["Sign-in"]
  node_prefs[("App preferences<br/>[AppPrefs.java]")]
end

subgraph group_mobile["Mobile capabilities"]
  node_downloads["Offline downloads"]
  node_download_storage[("Download storage")]
  node_background["Background playback"]
  node_casting["TV casting"]
end

subgraph group_enhance["Playback enhancements"]
  node_sponsorblock["SponsorBlock"]
  node_dearrow["DeArrow"]
  node_dislike["Dislike estimates<br/>[RatingWriter.java]"]
end

node_user(("Phone user"))

node_user -->|"browses"| node_browse
node_user -->|"searches"| node_search
node_browse -.->|"opens video"| node_details
node_search -.->|"selects video"| node_details
node_details -.->|"opens player"| node_navigation
node_navigation -->|"routes to"| node_playback_view
node_playback -->|"sets view"| node_playback_view
node_playback -.->|"controls"| node_player_engine
node_player_engine -->|"selects tracks"| node_tracks
node_playback -->|"fetches media"| node_media_service
node_playback -.->|"saves progress"| node_playback_state
node_playback -->|"plays video"| node_video
node_user -->|"signs in"| node_signin
node_signin -->|"authenticates"| node_media_service
node_media_service -->|"loads account content"| node_browse
node_user -->|"saves offline"| node_downloads
node_downloads -->|"stores downloads"| node_download_storage
node_downloads -->|"downloads video"| node_video
node_user -->|"keeps playing"| node_background
node_background -->|"controls playback"| node_playback
node_user -->|"casts video"| node_casting
node_casting -->|"surfaces player"| node_playback_view
node_playback -.->|"uses segments"| node_sponsorblock
node_playback -.->|"enhances titles"| node_dearrow
node_playback -.->|"shows estimates"| node_dislike
node_user -.->|"configures app"| node_prefs

click node_browse "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/BrowsePresenter.java"
click node_search "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/SearchPresenter.java"
click node_details "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/DetailsPresenter.java"
click node_navigation "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/views/ViewManager.java"
click node_playback "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/PlaybackPresenter.java"
click node_playback_view "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/views/PlaybackView.java"
click node_player_engine "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/playback/manager/PlayerEngine.java"
click node_tracks "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/exoplayer/selector/TrackSelectorManager.java"
click node_video "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/data/Video.java"
click node_playback_state "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/playback/service/VideoStateService.java"
click node_media_service "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/misc/MediaServiceManager.java"
click node_signin "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/YTSignInPresenter.java"
click node_prefs "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/prefs/AppPrefs.java"
click node_downloads "https://github.com/aleixrodriala/newtube/blob/main/smarttubetv/src/stmobile/java/com/newtube/mobile/downloads/MobileDownloadService.java"
click node_download_storage "https://github.com/aleixrodriala/newtube/blob/main/smarttubetv/src/stmobile/java/com/newtube/mobile/downloads/DownloadStorage.java"
click node_background "https://github.com/aleixrodriala/newtube/blob/main/smarttubetv/src/stmobile/java/com/newtube/mobile/ui/playback/MobilePlaybackService.java"
click node_casting "https://github.com/aleixrodriala/newtube/blob/main/smarttubetv/src/stmobile/java/com/newtube/mobile/casting/CastSessionService.java"
click node_sponsorblock "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/playback/controllers/SponsorBlockController.java"
click node_dearrow "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/misc/DeArrowProcessor.java"
click node_dislike "https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/playback/controllers/RatingWriter.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_browse,node_search,node_details,node_navigation,node_user toneBlue
class node_playback,node_playback_view,node_player_engine,node_tracks,node_video,node_playback_state,node_media_service toneAmber
class node_signin,node_prefs toneMint
class node_downloads,node_download_storage,node_background,node_casting toneRose
class node_sponsorblock,node_dearrow,node_dislike toneIndigo
```

## Components

### App experience

- [Browse and search](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/BrowsePresenter.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/BrowsePresenter.java`
- [Search](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/SearchPresenter.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/SearchPresenter.java`
- [Video details](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/DetailsPresenter.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/DetailsPresenter.java`
- [View navigation](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/views/ViewManager.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/views/ViewManager.java`

### Playback and media

- [Playback presenter](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/PlaybackPresenter.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/PlaybackPresenter.java`
- [Playback view](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/views/PlaybackView.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/views/PlaybackView.java`
- [Player engine](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/playback/manager/PlayerEngine.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/playback/manager/PlayerEngine.java`
- [Track selection](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/exoplayer/selector/TrackSelectorManager.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/exoplayer/selector/TrackSelectorManager.java`
- [Video model](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/data/Video.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/data/Video.java`
- [Playback history](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/playback/service/VideoStateService.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/playback/service/VideoStateService.java`
- [YouTube media engine](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/misc/MediaServiceManager.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/misc/MediaServiceManager.java`

### Account and preferences

- [Sign-in](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/YTSignInPresenter.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/YTSignInPresenter.java`
- [App preferences](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/prefs/AppPrefs.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/prefs/AppPrefs.java`

### Mobile capabilities

- [Offline downloads](https://github.com/aleixrodriala/newtube/blob/main/smarttubetv/src/stmobile/java/com/newtube/mobile/downloads/MobileDownloadService.java): `smarttubetv/src/stmobile/java/com/newtube/mobile/downloads/MobileDownloadService.java`
- [Download storage](https://github.com/aleixrodriala/newtube/blob/main/smarttubetv/src/stmobile/java/com/newtube/mobile/downloads/DownloadStorage.java): `smarttubetv/src/stmobile/java/com/newtube/mobile/downloads/DownloadStorage.java`
- [Background playback](https://github.com/aleixrodriala/newtube/blob/main/smarttubetv/src/stmobile/java/com/newtube/mobile/ui/playback/MobilePlaybackService.java): `smarttubetv/src/stmobile/java/com/newtube/mobile/ui/playback/MobilePlaybackService.java`
- [TV casting](https://github.com/aleixrodriala/newtube/blob/main/smarttubetv/src/stmobile/java/com/newtube/mobile/casting/CastSessionService.java): `smarttubetv/src/stmobile/java/com/newtube/mobile/casting/CastSessionService.java`

### Playback enhancements

- [SponsorBlock](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/playback/controllers/SponsorBlockController.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/playback/controllers/SponsorBlockController.java`
- [DeArrow](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/misc/DeArrowProcessor.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/misc/DeArrowProcessor.java`
- [Dislike estimates](https://github.com/aleixrodriala/newtube/blob/main/common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/playback/controllers/RatingWriter.java): `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/playback/controllers/RatingWriter.java`

### Other components

- **Phone user**

## Connections

- Phone user → Browse and search: browses (evidence: `README.md`)
- Phone user → Search: searches (evidence: `README.md`)
- Browse and search → Video details: opens video
- Search → Video details: selects video
- Video details → View navigation: opens player
- View navigation → Playback view: routes to (evidence: `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/views/ViewManager.java`)
- Playback presenter → Playback view: sets view (evidence: `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/PlaybackPresenter.java`)
- Playback presenter → Player engine: controls
- Player engine → Track selection: selects tracks (evidence: `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/playback/manager/PlayerEngine.java`)
- Playback presenter → YouTube media engine: fetches media (evidence: `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/PlaybackPresenter.java`)
- Playback presenter → Playback history: saves progress
- Playback presenter → Video model: plays video (evidence: `common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/PlaybackPresenter.java`)
- Phone user → Sign-in: signs in (evidence: `README.md`)
- Sign-in → YouTube media engine: authenticates (evidence: `README.md`)
- YouTube media engine → Browse and search: loads account content (evidence: `README.md`)
- Phone user → Offline downloads: saves offline (evidence: `README.md`)
- Offline downloads → Download storage: stores downloads (evidence: `smarttubetv/src/stmobile/java/com/newtube/mobile/downloads/MobileDownloadService.java`)
- Offline downloads → Video model: downloads video
- Phone user → Background playback: keeps playing (evidence: `README.md`)
- Background playback → Playback presenter: controls playback (evidence: `smarttubetv/src/stmobile/java/com/newtube/mobile/ui/playback/MobilePlaybackService.java`)
- Phone user → TV casting: casts video (evidence: `README.md`)
- TV casting → Playback view: surfaces player (evidence: `smarttubetv/src/stmobile/java/com/newtube/mobile/casting/CastSessionService.java`)
- Playback presenter → SponsorBlock: uses segments (evidence: `README.md`)
- Playback presenter → DeArrow: enhances titles (evidence: `README.md`)
- Playback presenter → Dislike estimates: shows estimates (evidence: `README.md`)
- Phone user → App preferences: configures app
