How itsmechinmoy/echo-nightly works
Echo is an Android extension-based music player: users browse or search extension-provided music, select media, and play or download it. Its runtime separates Android UI, extension integration, playback, and download processing, with shared media/client contracts in the multiplatform common module. The search-to-extension call and selected playback wiring are supported by excerpts or the source index; other feature links are marked unverified where implementation was not sampled.
Main entry points: ExtensionLoader.kt Extension loading · SearchFragment.kt Music search · PlayerService.kt Player service · Downloader.kt Download coordinator
Components 27
Android experience
- Main activity
app/src/main/java/dev/brahmkshatriya/echo/MainActivity.kt - Music search
app/src/main/java/dev/brahmkshatriya/echo/ui/main/search/SearchFragment.kt - Browse feeds
app/src/main/java/dev/brahmkshatriya/echo/ui/feed/FeedViewModel.kt - Media details
app/src/main/java/dev/brahmkshatriya/echo/ui/media/MediaDetailsViewModel.kt - Player interface
app/src/main/java/dev/brahmkshatriya/echo/ui/player/PlayerViewModel.kt - Playlists
app/src/main/java/dev/brahmkshatriya/echo/ui/playlist/edit/EditPlaylistViewModel.kt
Extension platform
- Extension loading
app/src/main/java/dev/brahmkshatriya/echo/extensions/ExtensionLoader.kt - Extension access
app/src/main/java/dev/brahmkshatriya/echo/extensions/ExtensionUtils.kt - Extension repositories
app/src/main/java/dev/brahmkshatriya/echo/extensions/repo/ExtensionRepository.kt - Extension and user data
app/src/main/java/dev/brahmkshatriya/echo/extensions/db/ExtensionDatabase.kt - Offline extension
app/src/main/java/dev/brahmkshatriya/echo/extensions/builtin/offline/OfflineExtension.kt - Unified library
app/src/main/java/dev/brahmkshatriya/echo/extensions/builtin/unified/UnifiedExtension.kt - Unified media store
app/src/main/java/dev/brahmkshatriya/echo/extensions/builtin/unified/UnifiedDatabase.kt
Playback
- Player service
app/src/main/java/dev/brahmkshatriya/echo/playback/PlayerService.kt - Stream resolution
app/src/main/java/dev/brahmkshatriya/echo/playback/source/StreamableResolver.kt - Player state
app/src/main/java/dev/brahmkshatriya/echo/playback/PlayerState.kt
Downloads
- Download screen
app/src/main/java/dev/brahmkshatriya/echo/ui/download/DownloadViewModel.kt - Download worker
app/src/main/java/dev/brahmkshatriya/echo/download/DownloadWorker.kt - Download coordinator
app/src/main/java/dev/brahmkshatriya/echo/download/Downloader.kt - Download task manager
app/src/main/java/dev/brahmkshatriya/echo/download/tasks/TaskManager.kt - Download records
app/src/main/java/dev/brahmkshatriya/echo/download/db/DownloadDatabase.kt
Shared contracts
- Extension client contracts
common/src/commonMain/kotlin/dev/brahmkshatriya/echo/common/clients/SearchFeedClient.kt - Feed models
common/src/commonMain/kotlin/dev/brahmkshatriya/echo/common/models/Feed.kt - Media item models
common/src/commonMain/kotlin/dev/brahmkshatriya/echo/common/models/EchoMediaItem.kt - Track model
common/src/commonMain/kotlin/dev/brahmkshatriya/echo/common/models/Track.kt - Streamable model
common/src/commonMain/kotlin/dev/brahmkshatriya/echo/common/models/Streamable.kt
Other components
- Listener
Connections 26
- Listener → Main activity: opens app
- Main activity → Music search: hosts navigation
- Music search → Extension access: requests search feed
app/src/main/java/dev/brahmkshatriya/echo/ui/main/search/SearchFragment.kt - Music search → Extension client contracts: invokes search client
app/src/main/java/dev/brahmkshatriya/echo/ui/main/search/SearchFragment.kt - Music search → Feed models: displays feed
app/src/main/java/dev/brahmkshatriya/echo/ui/main/search/SearchFragment.kt - Listener → Browse feeds: browses
- Browse feeds → Extension access: loads extension data
- Listener → Media details: selects media
- Listener → Playlists: edits playlists
- Listener → Player interface: controls playback
- Extension access → Extension loading: uses loaded extensions
- Extension loading → Extension repositories: loads repositories
- Extension loading → Extension and user data: stores extension data
- Extension loading → Offline extension: provides local media
- Extension loading → Unified library: provides unified library
- Unified library → Unified media store: persists library media
app/src/main/java/dev/brahmkshatriya/echo/extensions/builtin/unified/UnifiedDatabase.kt - Player interface → Player service: controls player
- Player service → Stream resolution: resolves streams
- Player service → Player state: uses playback state
app/src/main/java/dev/brahmkshatriya/echo/playback/PlayerService.kt - Player service → Extension loading: uses extension services
app/src/main/java/dev/brahmkshatriya/echo/playback/PlayerService.kt - Download worker → Download coordinator: runs download
app/src/main/java/dev/brahmkshatriya/echo/download/DownloadWorker.kt - Download coordinator → Download task manager: coordinates tasks
app/src/main/java/dev/brahmkshatriya/echo/download/tasks/TaskManager.kt - Download screen → Download coordinator: manages downloads
- Download coordinator → Download records: persists task state
app/src/main/java/dev/brahmkshatriya/echo/download/Downloader.kt - Track model → Media item models: implements media item
common/src/commonMain/kotlin/dev/brahmkshatriya/echo/common/models/Track.kt - Track model → Streamable model: carries streamables
common/src/commonMain/kotlin/dev/brahmkshatriya/echo/common/models/Track.kt