Native Android client for Spotify, built with Jetpack Compose
Kotlin ad-freeadblockandroidjetpack-composekotlinlyricsmusic-playermusic-videomyspotispotifyspotify-adblockerspotify-clientspotify-connectspotui
Contributing to Myspoti
Thanks for helping. Bug reports (with a diagnostic report from Settings), fixes and translations are all welcome.
Build and test
Requirements: JDK 17+ and the Android SDK (compileSdk 37). The Android project is in base/.
cd base
./gradlew assembleDebug
./gradlew :app:testDebugUnitTest :api-spotify:test
Put your SDK path in base/local.properties (sdk.dir=...). The live API tests (:host-cdp:test) need a desktop Chrome signed in to the Web Player; see the README.
Changes
- Keep a change focused, and write it like the code around it. Texts in the repository (code, comments, strings in
values/, docs) are in English; translations go in the matchingvalues-xx/folder. - Add or update a unit test when you fix a bug or change a rule.
- Commit messages are one plain sentence in English that says what changes for the user (or what was wrong), not a list of files.
Rules
- Extensions API: an extension call that is accepted today must never become an error. New fields and calls are fine; removing, renaming or tightening an existing one is not.
- Spotify: Myspoti talks to Spotify the way its Web Player does. No contribution may bypass, weaken or work around Spotify's protections (DRM, licences, attestation, rate limits), and none may add a Spotify audio download or decryption.
- License: Myspoti is GPL-3.0. Your contribution is released under the same license. If you reuse this code in another project, keep the notices, credit Myspoti (https://github.com/kota-zo/myspoti) and publish your complete source under GPL-3.0; closing the source or changing the license is a violation.