How lelonio/square works
Square is an Android music client for Spotify Premium and YouTube Music. A listener chooses a source, browses or searches its catalogue, and plays music through the app’s shared player; the README documents library management, lyrics, effects, video, and offline playback as additional capabilities. The graph groups those product stages and the main internal playback layer. Some source-specific wiring is not shown in the excerpts, so documented capability links use the README; unsampled implementation details are not inferred.
Main entry points: PlayerScreen.kt Player interface · PlaybackService.kt Playback service · SearchScreen.kt Browse and search · SpotifyWebPlayback.kt Spotify backend
Components 21
App experience
- Android UI
app/src/main/java/dev/lelonio/square/ui/MainActivity.kt - Browse and search
app/src/main/java/dev/lelonio/square/ui/search/SearchScreen.kt - Player interface
app/src/main/java/dev/lelonio/square/ui/player/PlayerScreen.kt
Music sources
- Spotify backend
app/src/main/java/dev/lelonio/square/backend/spotify/SpotifyWebPlayback.kt - YouTube backend
app/src/main/java/dev/lelonio/square/backend/youtube/YouTubeBackend.kt - YouTube Music API
innertube/src/main/kotlin/com/metrolist/innertube/YouTube.kt - Spotify account
app/src/main/java/dev/lelonio/square/auth/SpotifyOAuth.kt
Playback and audio
- Playback service
app/src/main/java/dev/lelonio/square/playback/PlaybackService.kt - Play queue
app/src/main/java/dev/lelonio/square/playback/PlayQueue.kt - Spotify engine
native/src/engine.rs - Audio effects
app/src/main/java/dev/lelonio/square/playback/AudioEffects.kt - Music video mode
app/src/main/java/dev/lelonio/square/backend/youtube/YouTubeVideoMode.kt
Library and downloads
- Library and playlists
app/src/main/java/dev/lelonio/square/ui/library/LibraryScreen.kt - Catalogue data
app/src/main/java/dev/lelonio/square/data/Catalog.kt - Download service
app/src/main/java/dev/lelonio/square/download/DownloadService.kt - Download queue
app/src/main/java/dev/lelonio/square/download/DownloadQueue.kt - Offline mode
app/src/main/java/dev/lelonio/square/playback/OfflineMode.kt
Listening features
- Lyrics and translation
app/src/main/java/dev/lelonio/square/backend/lyrics/SpotifyLyrics.kt - Spotify Connect
app/src/main/java/dev/lelonio/square/data/RemoteConnect.kt - Radio and discovery
app/src/main/java/dev/lelonio/square/ui/browse/RadioScreen.kt
Other components
- Listener
Connections 21
- Listener → Android UI: uses
README.md - Android UI → Browse and search: opens
README.md - Browse and search → Spotify backend: selects music
README.md - Browse and search → YouTube backend: selects music
README.md - YouTube backend → YouTube Music API: queries catalogue
README.md - Spotify backend → Spotify account: uses account
README.md - Listener → Player interface: controls playback
README.md - Player interface → Playback service: controls
app/src/main/java/dev/lelonio/square/playback/PlaybackService.kt - Playback service → Spotify backend: selects player
app/src/main/java/dev/lelonio/square/playback/PlaybackService.kt - Playback service → Play queue: manages queue
app/src/main/java/dev/lelonio/square/playback/PlaybackService.kt - Playback service → Spotify engine: controls engine
app/src/main/java/dev/lelonio/square/playback/PlaybackService.kt - Player interface → Audio effects: adjusts sound
README.md - Player interface → Music video mode: switches video
README.md - Listener → Library and playlists: manages library
README.md - Library and playlists → Catalogue data: browses catalogue
README.md - Listener → Download service: requests downloads
README.md - Download service → Download queue: wakes queue
app/src/main/java/dev/lelonio/square/download/DownloadService.kt - Playback service → Offline mode: supports offline
README.md - Player interface → Lyrics and translation: shows lyrics
README.md - Spotify backend → Spotify Connect: supports Connect
README.md - Browse and search → Radio and discovery: opens discovery
README.md