dependencies {
    implementation(libs.subsonicClient)
}

// Using a username and password
val client = SubsonicClient(
    baseUrl = "https://your-server.com",
    auth = SubsonicAuth.Token(
        username = "your-username",
        password = "your-password"
    )
)

// Using an API key (not universally supported, check your servers compatible authentication)
val client = SubsonicClient(
    baseUrl = "https://your-server.com",
    auth = SubsonicAuth.Key(apiKey = "your-api-key")
)

// Test connectivity
client.ping()

// Browse library
val artists = client.getArtists()
val artist = client.getArtist(id = "123")
val album = client.getAlbum(id = "456")

// Search
val results = client.searchID3(query = "Beatles")

// Playlists
val playlists = client.getPlaylists()
val newPlaylist = client.createPlaylist(name = "My Mix", songIds = listOf("1", "2", "3"))

// Streaming
val streamUrl = client.getStreamUrl(id = "song-123", maxBitRate = 320)
val coverArtUrl = client.getCoverArtUrl(id = album.coverArt, size = "500")

// Star/Rate
client.star("song-123")
client.setRating(id = "song-123", rating = 5)

// Scrobble
client.scrobble(id = "song-123")

try {
    val album = client.getAlbum(id = "invalid-id")
} catch (e: SubsonicException) {
    println("${e.code}: ${e.message}")
}

// Use a specific Ktor engine
val client = SubsonicClient(
    baseUrl = "https://your-server.com",
    auth = SubsonicAuth.Token(username = "user", password = "pass")
) {
    // Additional Ktor client configuration
    install(HttpTimeout) {
        requestTimeoutMillis = 30000
    }
}