Loading repository data…
nubasu / repository
Spotify Web API wrapper for Kotlin Multiplatform
Spotify Web API wrapper for Kotlin Multiplatform.
This repository provides a type-safe, coroutine-friendly Spotify API client for Kotlin, Android, iOS, JVM, and JS.
Dependency coordinates:
io.github.nubasukotlin-spotify-web-api-wrapperlibs.versions.toml (Version Catalog)gradle/libs.versions.toml:
[versions]
kotlinSpotifyWebApiWrapper = "2.0.0"
[libraries]
kotlin-spotify-web-api-wrapper = { module = "io.github.nubasu:kotlin-spotify-web-api-wrapper", version.ref = "kotlinSpotifyWebApiWrapper" }
build.gradle.kts:
repositories {
mavenCentral()
}
commonMain.dependencies {
implementation(libs.kotlin.spotify.web.api.wrapper)
}
build.gradle.kts (Kotlin DSL)repositories {
mavenCentral()
}
commonMain.dependencies {
implementation("io.github.nubasu:kotlin-spotify-web-api-wrapper:2.0.0")
}
build.gradle (Groovy DSL)repositories {
mavenCentral()
}
dependencies {
implementation 'io.github.nubasu:kotlin-spotify-web-api-wrapper:2.0.0'
}
composeApp/.PKCE auth -> load current user's playlists -> start/pause playback.spotifyauth://callback (configure this in Spotify Dashboard redirect URIs).http://127.0.0.1:8888/callback (configure this in Spotify Dashboard redirect URIs)../gradlew :composeApp:run.import com.nubasu.spotify.webapi.wrapper.SpotifyClient
import com.nubasu.spotify.webapi.wrapper.api.authorization.SpotifyAuthManager
val auth = SpotifyAuthManager(
clientId = "YOUR_CLIENT_ID",
redirectUri = "your.app://callback"
)
val pkce = auth.startPkceAuthorizationAndLaunch(scope = listOf("user-read-email"))
// Android/iOS: prefer in-app authentication UI, otherwise open the browser
// After the redirect comes back:
auth.completePkceAuthorizationFromRedirectUri(redirectedUri)
// asTokenProvider() wires automatic token refresh into every API call:
// PKCE / Authorization Code refresh with the stored refresh token,
// Client Credentials reacquires a fresh token (no refresh_token needed).
// A refresh failure surfaces as the original Spotify error inside
// SpotifyResult.Failure - API calls never throw.
val spotify = SpotifyClient(tokenProvider = auth.asTokenProvider())
val album = spotify.albums.getAlbum("album-id")
shared/api/*.api and enforced by
binary-compatibility-validator (apiCheck) in CI.data class for serialization and destructuring ergonomics, accepting that
adding fields can break copy/componentN binary compatibility — such
changes are treated as breaking and reserved for major releases, with bcv as
the tripwire.@Deprecated warnings) until Spotify removes
them. Wrapper-level compatibility shims (for example TokenHolder) are
@Deprecated(WARNING) and are removed in the next major release.PRs/issues are welcome.
Selected from shared topics, language and repository description—not editorial ratings.
adamint /
Spotify Web API wrapper for Kotlin, Java, JS, and Native - Targets JVM, Android, JS (browser), Native (Desktop), and Apple tvOS/iOS. Includes a Spotify Web Playback SDK wrapper for Kotlin/JS, and a spotify-auth wrapper for Kotlin/Android.