# oxyroid/m3uandroid architecture

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

- Interactive diagram: https://gitdiagram.com/oxyroid/m3uandroid
- Repository: https://github.com/oxyroid/m3uandroid

## Overview

M3UAndroid is an Android IPTV player for phones, tablets, and TV. Users configure playlist sources, browse channels or favourites, and play a selected stream; settings also expose playlist management and extension controls. The graph separates presentation, business state, data/playback, and extension runtime. The README establishes the product and device scope; sampled app and player files support some navigation and playback links, while many listed subsystems are represented from the tree without asserting unverified call paths.

Main entry points: [`app/smartphone/src/main/java/com/m3u/smartphone/ui/App.kt`](https://github.com/oxyroid/m3uandroid/blob/master/app/smartphone/src/main/java/com/m3u/smartphone/ui/App.kt) (Smartphone app shell), [`data/src/main/java/com/m3u/data/service/internal/PlayerManagerImpl.kt`](https://github.com/oxyroid/m3uandroid/blob/master/data/src/main/java/com/m3u/data/service/internal/PlayerManagerImpl.kt) (Playback manager), [`app/tv/src/main/java/com/m3u/tv/App.kt`](https://github.com/oxyroid/m3uandroid/blob/master/app/tv/src/main/java/com/m3u/tv/App.kt) (TV app shell), [`business/playlist/src/main/java/com/m3u/business/playlist/PlaylistViewModel.kt`](https://github.com/oxyroid/m3uandroid/blob/master/business/playlist/src/main/java/com/m3u/business/playlist/PlaylistViewModel.kt) (Playlist state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["App presentation"]
  node_smartphone["Smartphone app shell<br/>[App.kt]"]
  node_tvapp["TV app shell<br/>[App.kt]"]
  node_playlistui["Playlist browsing<br/>[PlaylistScreen.kt]"]
  node_channelui["Channel player UI<br/>[PlayerActivity.kt]"]
  node_settingsui["Settings UI<br/>[SettingScreen.kt]"]
  node_remoteui["Remote control UI"]
  node_tvplayer["TV playback screen<br/>[TvPlayerScreen.kt]"]
end

subgraph group_business["Viewing and management"]
  node_playlistconfig["Playlist configuration"]
  node_playlistbrowse["Playlist state"]
  node_channelstate["Channel state"]
  node_favorites["Favourites"]
  node_recommend["Recommendations<br/>[Recommend.kt]"]
  node_settingsstate["Settings state"]
  node_tvhome["TV home state<br/>[TvHomeViewModel.kt]"]
end

subgraph group_data["Data and playback"]
  node_playlistrepo["Playlist repository"]
  node_catalog["Playlist and channel data<br/>[Playlist.kt]"]
  node_player["Playback manager"]
  node_providerimport["Provider importer"]
end

subgraph group_extensions["Extension platform"]
  node_extensionrepo["Extension management"]
  node_runtime["Extension runtime"]
  node_typedservice["Typed extension service"]
  node_service["Android extension service"]
end

node_viewer(("Viewer"))

node_viewer -->|"uses"| node_smartphone
node_viewer -->|"uses"| node_tvapp
node_smartphone -->|"navigates to"| node_playlistconfig
node_smartphone -->|"opens"| node_channelui
node_smartphone -->|"renders"| node_playlistui
node_smartphone -->|"shows"| node_remoteui
node_smartphone -.->|"shows"| node_settingsui
node_playlistui -.->|"uses"| node_playlistbrowse
node_channelui -.->|"uses"| node_channelstate
node_settingsui -.->|"uses"| node_settingsstate
node_playlistconfig -.->|"updates"| node_playlistrepo
node_playlistrepo -.->|"reads and writes"| node_catalog
node_player -->|"reads channel"| node_catalog
node_player -->|"resolves playlist"| node_playlistrepo
node_channelstate -.->|"controls"| node_player
node_playlistbrowse -.->|"supports"| node_favorites
node_playlistbrowse -.->|"supports"| node_recommend
node_settingsstate -.->|"manages"| node_extensionrepo
node_extensionrepo -->|"registers extensions"| node_runtime
node_typedservice -->|"implements transport"| node_runtime
node_service -->|"delegates invocation"| node_typedservice
node_extensionrepo -.->|"provides contributions"| node_providerimport
node_tvapp -->|"uses"| node_tvhome
node_tvapp -->|"renders"| node_tvplayer
node_tvplayer -.->|"uses playback"| node_player

click node_smartphone "https://github.com/oxyroid/m3uandroid/blob/master/app/smartphone/src/main/java/com/m3u/smartphone/ui/App.kt"
click node_tvapp "https://github.com/oxyroid/m3uandroid/blob/master/app/tv/src/main/java/com/m3u/tv/App.kt"
click node_playlistui "https://github.com/oxyroid/m3uandroid/blob/master/app/smartphone/src/main/java/com/m3u/smartphone/ui/business/playlist/PlaylistScreen.kt"
click node_channelui "https://github.com/oxyroid/m3uandroid/blob/master/app/smartphone/src/main/java/com/m3u/smartphone/ui/business/channel/PlayerActivity.kt"
click node_settingsui "https://github.com/oxyroid/m3uandroid/blob/master/app/smartphone/src/main/java/com/m3u/smartphone/ui/business/setting/SettingScreen.kt"
click node_remoteui "https://github.com/oxyroid/m3uandroid/blob/master/app/smartphone/src/main/java/com/m3u/smartphone/ui/common/connect/RemoteControlSheet.kt"
click node_playlistconfig "https://github.com/oxyroid/m3uandroid/blob/master/business/playlist-configuration/src/main/java/com/m3u/business/playlist/configuration/PlaylistConfigurationViewModel.kt"
click node_playlistbrowse "https://github.com/oxyroid/m3uandroid/blob/master/business/playlist/src/main/java/com/m3u/business/playlist/PlaylistViewModel.kt"
click node_channelstate "https://github.com/oxyroid/m3uandroid/blob/master/business/channel/src/main/java/com/m3u/business/channel/ChannelViewModel.kt"
click node_favorites "https://github.com/oxyroid/m3uandroid/blob/master/business/favorite/src/main/java/com/m3u/business/favorite/FavouriteViewModel.kt"
click node_recommend "https://github.com/oxyroid/m3uandroid/blob/master/business/foryou/src/main/java/com/m3u/business/foryou/Recommend.kt"
click node_settingsstate "https://github.com/oxyroid/m3uandroid/blob/master/business/setting/src/main/java/com/m3u/business/setting/SettingViewModel.kt"
click node_playlistrepo "https://github.com/oxyroid/m3uandroid/blob/master/data/src/main/java/com/m3u/data/repository/playlist/PlaylistRepositoryImpl.kt"
click node_catalog "https://github.com/oxyroid/m3uandroid/blob/master/data/src/main/java/com/m3u/data/database/model/Playlist.kt"
click node_player "https://github.com/oxyroid/m3uandroid/blob/master/data/src/main/java/com/m3u/data/service/internal/PlayerManagerImpl.kt"
click node_providerimport "https://github.com/oxyroid/m3uandroid/blob/master/data/src/main/java/com/m3u/data/extension/SubscriptionProviderImporter.kt"
click node_extensionrepo "https://github.com/oxyroid/m3uandroid/blob/master/data/src/main/java/com/m3u/data/repository/plugin/ExtensionPluginRepositoryImpl.kt"
click node_runtime "https://github.com/oxyroid/m3uandroid/blob/master/extension/runtime/src/main/kotlin/com/m3u/extension/runtime/ExtensionRuntime.kt"
click node_typedservice "https://github.com/oxyroid/m3uandroid/blob/master/extension/sdk-android/src/main/java/com/m3u/extension/sdk/android/TypedExtensionService.kt"
click node_service "https://github.com/oxyroid/m3uandroid/blob/master/extension/sdk-android/src/main/java/com/m3u/extension/sdk/android/ExtensionService.kt"
click node_tvhome "https://github.com/oxyroid/m3uandroid/blob/master/app/tv/src/main/java/com/m3u/tv/TvHomeViewModel.kt"
click node_tvplayer "https://github.com/oxyroid/m3uandroid/blob/master/app/tv/src/main/java/com/m3u/tv/TvPlayerScreen.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_smartphone,node_tvapp,node_playlistui,node_channelui,node_settingsui,node_remoteui,node_tvplayer,node_viewer toneBlue
class node_playlistconfig,node_playlistbrowse,node_channelstate,node_favorites,node_recommend,node_settingsstate,node_tvhome toneAmber
class node_playlistrepo,node_catalog,node_player,node_providerimport toneMint
class node_extensionrepo,node_runtime,node_typedservice,node_service toneRose
```

## Components

### App presentation

- [Smartphone app shell](https://github.com/oxyroid/m3uandroid/blob/master/app/smartphone/src/main/java/com/m3u/smartphone/ui/App.kt): `app/smartphone/src/main/java/com/m3u/smartphone/ui/App.kt`
- [TV app shell](https://github.com/oxyroid/m3uandroid/blob/master/app/tv/src/main/java/com/m3u/tv/App.kt): `app/tv/src/main/java/com/m3u/tv/App.kt`
- [Playlist browsing](https://github.com/oxyroid/m3uandroid/blob/master/app/smartphone/src/main/java/com/m3u/smartphone/ui/business/playlist/PlaylistScreen.kt): `app/smartphone/src/main/java/com/m3u/smartphone/ui/business/playlist/PlaylistScreen.kt`
- [Channel player UI](https://github.com/oxyroid/m3uandroid/blob/master/app/smartphone/src/main/java/com/m3u/smartphone/ui/business/channel/PlayerActivity.kt): `app/smartphone/src/main/java/com/m3u/smartphone/ui/business/channel/PlayerActivity.kt`
- [Settings UI](https://github.com/oxyroid/m3uandroid/blob/master/app/smartphone/src/main/java/com/m3u/smartphone/ui/business/setting/SettingScreen.kt): `app/smartphone/src/main/java/com/m3u/smartphone/ui/business/setting/SettingScreen.kt`
- [Remote control UI](https://github.com/oxyroid/m3uandroid/blob/master/app/smartphone/src/main/java/com/m3u/smartphone/ui/common/connect/RemoteControlSheet.kt): `app/smartphone/src/main/java/com/m3u/smartphone/ui/common/connect/RemoteControlSheet.kt`
- [TV playback screen](https://github.com/oxyroid/m3uandroid/blob/master/app/tv/src/main/java/com/m3u/tv/TvPlayerScreen.kt): `app/tv/src/main/java/com/m3u/tv/TvPlayerScreen.kt`

### Viewing and management

- [Playlist configuration](https://github.com/oxyroid/m3uandroid/blob/master/business/playlist-configuration/src/main/java/com/m3u/business/playlist/configuration/PlaylistConfigurationViewModel.kt): `business/playlist-configuration/src/main/java/com/m3u/business/playlist/configuration/PlaylistConfigurationViewModel.kt`
- [Playlist state](https://github.com/oxyroid/m3uandroid/blob/master/business/playlist/src/main/java/com/m3u/business/playlist/PlaylistViewModel.kt): `business/playlist/src/main/java/com/m3u/business/playlist/PlaylistViewModel.kt`
- [Channel state](https://github.com/oxyroid/m3uandroid/blob/master/business/channel/src/main/java/com/m3u/business/channel/ChannelViewModel.kt): `business/channel/src/main/java/com/m3u/business/channel/ChannelViewModel.kt`
- [Favourites](https://github.com/oxyroid/m3uandroid/blob/master/business/favorite/src/main/java/com/m3u/business/favorite/FavouriteViewModel.kt): `business/favorite/src/main/java/com/m3u/business/favorite/FavouriteViewModel.kt`
- [Recommendations](https://github.com/oxyroid/m3uandroid/blob/master/business/foryou/src/main/java/com/m3u/business/foryou/Recommend.kt): `business/foryou/src/main/java/com/m3u/business/foryou/Recommend.kt`
- [Settings state](https://github.com/oxyroid/m3uandroid/blob/master/business/setting/src/main/java/com/m3u/business/setting/SettingViewModel.kt): `business/setting/src/main/java/com/m3u/business/setting/SettingViewModel.kt`
- [TV home state](https://github.com/oxyroid/m3uandroid/blob/master/app/tv/src/main/java/com/m3u/tv/TvHomeViewModel.kt): `app/tv/src/main/java/com/m3u/tv/TvHomeViewModel.kt`

### Data and playback

- [Playlist repository](https://github.com/oxyroid/m3uandroid/blob/master/data/src/main/java/com/m3u/data/repository/playlist/PlaylistRepositoryImpl.kt): `data/src/main/java/com/m3u/data/repository/playlist/PlaylistRepositoryImpl.kt`
- [Playlist and channel data](https://github.com/oxyroid/m3uandroid/blob/master/data/src/main/java/com/m3u/data/database/model/Playlist.kt): `data/src/main/java/com/m3u/data/database/model/Playlist.kt`
- [Playback manager](https://github.com/oxyroid/m3uandroid/blob/master/data/src/main/java/com/m3u/data/service/internal/PlayerManagerImpl.kt): `data/src/main/java/com/m3u/data/service/internal/PlayerManagerImpl.kt`
- [Provider importer](https://github.com/oxyroid/m3uandroid/blob/master/data/src/main/java/com/m3u/data/extension/SubscriptionProviderImporter.kt): `data/src/main/java/com/m3u/data/extension/SubscriptionProviderImporter.kt`

### Extension platform

- [Extension management](https://github.com/oxyroid/m3uandroid/blob/master/data/src/main/java/com/m3u/data/repository/plugin/ExtensionPluginRepositoryImpl.kt): `data/src/main/java/com/m3u/data/repository/plugin/ExtensionPluginRepositoryImpl.kt`
- [Extension runtime](https://github.com/oxyroid/m3uandroid/blob/master/extension/runtime/src/main/kotlin/com/m3u/extension/runtime/ExtensionRuntime.kt): `extension/runtime/src/main/kotlin/com/m3u/extension/runtime/ExtensionRuntime.kt`
- [Typed extension service](https://github.com/oxyroid/m3uandroid/blob/master/extension/sdk-android/src/main/java/com/m3u/extension/sdk/android/TypedExtensionService.kt): `extension/sdk-android/src/main/java/com/m3u/extension/sdk/android/TypedExtensionService.kt`
- [Android extension service](https://github.com/oxyroid/m3uandroid/blob/master/extension/sdk-android/src/main/java/com/m3u/extension/sdk/android/ExtensionService.kt): `extension/sdk-android/src/main/java/com/m3u/extension/sdk/android/ExtensionService.kt`

### Other components

- **Viewer**

## Connections

- Viewer → Smartphone app shell: uses (evidence: `README.md`)
- Viewer → TV app shell: uses (evidence: `README.md`)
- Smartphone app shell → Playlist configuration: navigates to (evidence: `app/smartphone/src/main/java/com/m3u/smartphone/ui/App.kt`)
- Smartphone app shell → Channel player UI: opens (evidence: `app/smartphone/src/main/java/com/m3u/smartphone/ui/App.kt`)
- Smartphone app shell → Playlist browsing: renders (evidence: `app/smartphone/src/main/java/com/m3u/smartphone/ui/App.kt`)
- Smartphone app shell → Remote control UI: shows (evidence: `app/smartphone/src/main/java/com/m3u/smartphone/ui/App.kt`)
- Smartphone app shell → Settings UI: shows
- Playlist browsing → Playlist state: uses
- Channel player UI → Channel state: uses
- Settings UI → Settings state: uses
- Playlist configuration → Playlist repository: updates
- Playlist repository → Playlist and channel data: reads and writes (evidence: `data/src/main/java/com/m3u/data/repository/playlist/PlaylistRepositoryImpl.kt`)
- Playback manager → Playlist and channel data: reads channel (evidence: `data/src/main/java/com/m3u/data/service/internal/PlayerManagerImpl.kt`)
- Playback manager → Playlist repository: resolves playlist (evidence: `data/src/main/java/com/m3u/data/service/internal/PlayerManagerImpl.kt`)
- Channel state → Playback manager: controls
- Playlist state → Favourites: supports
- Playlist state → Recommendations: supports
- Settings state → Extension management: manages
- Extension management → Extension runtime: registers extensions (evidence: `data/src/main/java/com/m3u/data/repository/plugin/ExtensionPluginRepositoryImpl.kt`)
- Typed extension service → Extension runtime: implements transport (evidence: `extension/sdk-android/src/main/java/com/m3u/extension/sdk/android/TypedExtensionService.kt`)
- Android extension service → Typed extension service: delegates invocation (evidence: `extension/sdk-android/src/main/java/com/m3u/extension/sdk/android/ExtensionService.kt`)
- Extension management → Provider importer: provides contributions (evidence: `data/src/main/java/com/m3u/data/repository/plugin/ExtensionPluginRepositoryImpl.kt`)
- TV app shell → TV home state: uses (evidence: `app/tv/src/main/java/com/m3u/tv/App.kt`)
- TV app shell → TV playback screen: renders (evidence: `app/tv/src/main/java/com/m3u/tv/App.kt`)
- TV playback screen → Playback manager: uses playback
