How oxyroid/m3uandroid works
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: ui/App.kt Smartphone app shell · PlayerManagerImpl.kt Playback manager · tv/App.kt TV app shell · PlaylistViewModel.kt Playlist state
Components 23
App presentation
- Smartphone app shell
app/smartphone/src/main/java/com/m3u/smartphone/ui/App.kt - TV app shell
app/tv/src/main/java/com/m3u/tv/App.kt - Playlist browsing
app/smartphone/src/main/java/com/m3u/smartphone/ui/business/playlist/PlaylistScreen.kt - Channel player UI
app/smartphone/src/main/java/com/m3u/smartphone/ui/business/channel/PlayerActivity.kt - Settings UI
app/smartphone/src/main/java/com/m3u/smartphone/ui/business/setting/SettingScreen.kt - Remote control UI
app/smartphone/src/main/java/com/m3u/smartphone/ui/common/connect/RemoteControlSheet.kt - TV playback screen
app/tv/src/main/java/com/m3u/tv/TvPlayerScreen.kt
Viewing and management
- Playlist configuration
business/playlist-configuration/src/main/java/com/m3u/business/playlist/configuration/PlaylistConfigurationViewModel.kt - Playlist state
business/playlist/src/main/java/com/m3u/business/playlist/PlaylistViewModel.kt - Channel state
business/channel/src/main/java/com/m3u/business/channel/ChannelViewModel.kt - Favourites
business/favorite/src/main/java/com/m3u/business/favorite/FavouriteViewModel.kt - Recommendations
business/foryou/src/main/java/com/m3u/business/foryou/Recommend.kt - Settings state
business/setting/src/main/java/com/m3u/business/setting/SettingViewModel.kt - TV home state
app/tv/src/main/java/com/m3u/tv/TvHomeViewModel.kt
Data and playback
- Playlist repository
data/src/main/java/com/m3u/data/repository/playlist/PlaylistRepositoryImpl.kt - Playlist and channel data
data/src/main/java/com/m3u/data/database/model/Playlist.kt - Playback manager
data/src/main/java/com/m3u/data/service/internal/PlayerManagerImpl.kt - Provider importer
data/src/main/java/com/m3u/data/extension/SubscriptionProviderImporter.kt
Extension platform
- Extension management
data/src/main/java/com/m3u/data/repository/plugin/ExtensionPluginRepositoryImpl.kt - Extension runtime
extension/runtime/src/main/kotlin/com/m3u/extension/runtime/ExtensionRuntime.kt - Typed extension service
extension/sdk-android/src/main/java/com/m3u/extension/sdk/android/TypedExtensionService.kt - Android extension service
extension/sdk-android/src/main/java/com/m3u/extension/sdk/android/ExtensionService.kt
Other components
- Viewer
Connections 25
- Viewer → Smartphone app shell: uses
README.md - Viewer → TV app shell: uses
README.md - Smartphone app shell → Playlist configuration: navigates to
app/smartphone/src/main/java/com/m3u/smartphone/ui/App.kt - Smartphone app shell → Channel player UI: opens
app/smartphone/src/main/java/com/m3u/smartphone/ui/App.kt - Smartphone app shell → Playlist browsing: renders
app/smartphone/src/main/java/com/m3u/smartphone/ui/App.kt - Smartphone app shell → Remote control UI: shows
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
data/src/main/java/com/m3u/data/repository/playlist/PlaylistRepositoryImpl.kt - Playback manager → Playlist and channel data: reads channel
data/src/main/java/com/m3u/data/service/internal/PlayerManagerImpl.kt - Playback manager → Playlist repository: resolves playlist
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
data/src/main/java/com/m3u/data/repository/plugin/ExtensionPluginRepositoryImpl.kt - Typed extension service → Extension runtime: implements transport
extension/sdk-android/src/main/java/com/m3u/extension/sdk/android/TypedExtensionService.kt - Android extension service → Typed extension service: delegates invocation
extension/sdk-android/src/main/java/com/m3u/extension/sdk/android/ExtensionService.kt - Extension management → Provider importer: provides contributions
data/src/main/java/com/m3u/data/repository/plugin/ExtensionPluginRepositoryImpl.kt - TV app shell → TV home state: uses
app/tv/src/main/java/com/m3u/tv/App.kt - TV app shell → TV playback screen: renders
app/tv/src/main/java/com/m3u/tv/App.kt - TV playback screen → Playback manager: uses playback