Launchers on Android 8+ and Android Auto put the old icon, a rounded square with a transparent margin, inside their own shape and filled the margin with white. Both apps now have an adaptive icon (the gradient behind a wave layer, which also serves as the themed monochrome icon), and the legacy PNGs are opaque full-bleed squares, so nothing is left to frame. make_icon.py draws both with --foreground and --square. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Musyx Mobile
An Android TV player for Yandex Music, written in Kotlin with Jetpack Compose for TV and Media3. It is the TV companion to the desktop Musyx (Rust, iced), and follows the same design.
Musyx is an unofficial client. It talks to the same undocumented API the official apps use, and it isn't affiliated with or endorsed by Yandex.
What it does
Everything the desktop app does, laid out for a remote: device-code sign-in with a QR for your phone (or a pasted token), Home (My Wave, recently played, personal playlists, the chart, new releases, genres), My Wave with its mood, character and language settings and other stations, search with suggestions and paged results, Collection (liked tracks, albums, artists, playlists, clips), album, artist, playlist, genre and podcast pages, and a Now Playing screen with the queue and synced lyrics (from LRCLIB when Yandex has none). Tracks can be liked, disliked, queued next or last, added to playlists, and used to start similar tracks; your own playlists can be created, renamed, made public or private, reordered and deleted. Playback runs in a media session, so it keeps going in the background and answers the remote's media keys. While music plays, the TV's own screen saver is replaced by one that drifts through the artist's photos and the cover with the artist, song, album and year (after the system's screen saver delay; paused for ten minutes or with nothing queued, the system's saver returns). Streaming quality goes up to FLAC (decrypted on the fly), and the interface is in English or Russian.
Hold select on a track row or a clip for its menu; the heart and the "more" button sit to the right of each row.
Stack
- Kotlin, Jetpack Compose with
androidx.tv:tv-materialfor the D-pad UI. - Media3 (ExoPlayer and
MediaSessionService) for playback, background audio, the Now Playing card and remote controls. - OkHttp and kotlinx.serialization for the Yandex Music API.
- Android Keystore for the OAuth token.
- Coil for covers (memory and disk cache) and ZXing for the sign-in QR.
Build and run
You need JDK 17 or newer (Android Studio's bundled JBR works) and the Android SDK with
platform 37. Point Gradle at the SDK with sdk.dir in local.properties (Android Studio
writes it) or ANDROID_HOME. The Gradle wrapper fetches everything else.
./gradlew assembleDebug
The APK lands in tv/build/outputs/apk/debug/tv-debug.apk. ./gradlew testDebugUnitTest
runs the JVM tests (the queue and player rules, API parsing and request signing, lyrics,
decryption and theme parity, mostly ported from the desktop tests), and ./gradlew lint runs Android
Lint, with a report in each module's build/reports/lint-results-debug.html.
The phone app builds with ./gradlew :mobile:assembleDebug and installs with
./gradlew :mobile:installDebug. To try it in Android Auto, run the Desktop Head Unit (SDK
Manager, SDK Tools, Android Auto Desktop Head Unit) against a phone with Android Auto, with
Auto's developer settings on and "Unknown sources" allowed, since the app isn't from Play.
To run the TV app, start an Android TV or Google TV emulator (Device Manager in Android Studio, TV category) or connect a TV with ADB debugging on, then:
./gradlew :tv:installDebug
adb shell am start -n it.panov.musyx.tv/.MainActivity
The app shows up in the TV launcher under its banner. It also installs on phones and tablets, since neither Leanback nor a touchscreen is required.
Generated resources
The icons, banner and fonts in tv/src/main/res come from assets/. Regenerate them after
changing the sources:
python3 tool/svg_to_vector.pyturnsassets/icons/*.svgintores/drawable/ic_<name>.xml. The drawables are white masks; code tints them with theme tokens.python3 tool/make_tv_assets.pydraws the 320×180 TV banner (drawable-xhdpi/banner.png) and scalesassets/icon/musyx.pnginto the launcher mipmaps. It needs Pillow.python3 tool/make_icon.py assets/icon/musyx.pngredraws the icon itself.- The fonts are copied by hand from
assets/fontstores/font(lower-case names).
CI and releases
Gitea Actions runs .gitea/workflows/ci.yml on every push to main and every pull request:
the unit tests, Lint and debug builds of both apps. A failed run keeps the reports as an
artifact.
To release, bump versionName and versionCode in tv/build.gradle.kts and/or
mobile/build.gradle.kts, commit, and push a tag named v<phone>-tv<tv>:
git tag v0.1.3-tv0.1.8 && git push origin v0.1.3-tv0.1.8
.gitea/workflows/release.yml then checks that the tag matches the versions, builds both
apps signed with the release key, and attaches tv-release.apk and mobile-release.apk to
the tag's release. It creates the release if there isn't one yet, with the commit subjects
since the previous tag as its notes; a release written by hand beforehand keeps its notes.
Running the workflow by hand from the Actions tab is a dry run that keeps the signed APKs as
an artifact instead of publishing.
The key comes from four repository secrets (Settings, Actions, Secrets):
RELEASE_KEYSTORE_BASE64 (the keystore, from base64 -i musyx-key.keystore),
RELEASE_STORE_PASSWORD, RELEASE_KEY_ALIAS and RELEASE_KEY_PASSWORD, the same values
keystore.properties holds locally.
Layout
core/: what the apps share (it.panov.musyx), undercore/src/main/java/it/panov/musyx:api/: the Yandex Music client, ported fromreference/ym-apiwith theyamusewire details inlined (Transport.ktheaders and errors,Auth.ktdevice flow,Signing.kt).player/:PlayerCore(queue, repeat, waves, reports; a pure port of the desktop player),ExoEngine(one ExoPlayer, withAesCtrDataSourcefor encrypted FLAC),PlaybackController(runs the core's effects) andSessionPlayer(the player the media session wraps).state/:AppState, the port of the desktopapp.rsandapp/edit.rs, plus search, sign-in and navigation state.data/: settings and the Keystore-encrypted credentials.res/: the strings the state layer shows (toasts, sign-in errors, quality names).
tv/: the Android TV app (it.panov.musyx.tv), undertv/src/main/java/it/panov/musyx/tv:player/PlaybackService.kt: the media session.ui/: the shell (drawer, mini player, dialogs, toasts),screens/andcomponents/. The theme isui/theme/Theme.kt, a 1:1 port ofDESIGN.md.
mobile/: the phone app (it.panov.musyx), undermobile/src/main/java/it/panov/musyx/mobile:PlaybackService.kt: aMediaLibraryService, so the notification, lock screen, Bluetooth and Android Auto all reach the player.Library.kt: the browse tree Android Auto shows (My Wave and stations, Home picks, the collection) and its search and voice requests.ArtworkProvider.kt: serves covers to Auto ascontent://URIs, Yandex hosts only.ui/: Material 3 screens over the sharedAppState;res/values/strings.xmlis copied from the TV app by name,strings_phone.xmlhas the phone's own.
gradle/libs.versions.toml: dependency versions.DESIGN.md: design tokens (colour, type, space, components), shared with the desktop app.design/mockup.html: the approved desktop mockup.assets/fonts: Onest and Unbounded (OFL). They go tores/fontin the app.assets/icons: Lucide icons (ISC). They become vector drawables in the app.assets/icon/musyx.png: the app icon, drawn bytool/make_icon.py.tool/: scripts that generate the icon, banner and vector drawables.reference/: a read-only snapshot of the desktop sources at musyx44f4a1f, to port from. Nothing here is built.reference/ym-api: the API client. It is the spec for the Kotlin client: endpoints, device-flow sign-in and token refresh,/get-file-infosigning, and the AES-CTR decryption of lossless streams.tests/live.rscovers the live calls.reference/musyx: the desktop app. The queue and My Wave logic (player/), screens, settings, and the Russian strings (i18n/ru.rs, forvalues-ru/strings.xml).
Licences
Musyx Mobile is MIT. Onest and Unbounded are OFL (assets/fonts), and Lucide icons are ISC
(assets/icons/LICENSE.txt).