Unofficial YouTube Music / Spotify Premium client for Android, built in Liquid Glass. Audio effects, Spotify Connect, listening history, 8 languages. Rust core on librespot.
Kotlin alternativeandroidandroid-applicationclientglassmorphisminnertubelibrespotliquid-glassspotifyspotify-connectspotifyapiyoutube-musicyoutube-playerytdlnis
package dev.lelonio.square.backend.lyrics
import dev.lelonio.square.data.Lyrics
import java.net.URLEncoder
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext
import okhttp3.OkHttpClient
import okhttp3.Request
import org.json.JSONObject
/**
* Word-timed lyrics from Better Lyrics, the YouTube Music extension's service.
*
* One request, by title, artist and length, answered with an Apple-style TTML
* document timed to the word, so the parsing, the word timings and any
* translation come from [Ttml] as they do for the archive in [Lossless]. A
* different archive from that one: where one misses a song the other often
* has it, which is why both are asked.
*
* A miss is ordinary and answers null; so does anything that is not a
* document this can read.
*/
object BetterLyrics {
private val http = OkHttpClient()
suspend fun lyrics(title: String, artist: String, durationMs: Long): Lyrics? =
withContext(Dispatchers.IO) {
val cleaned = title.songTitle()
if (cleaned.isBlank()) return@withContext null
val url = buildString {
append(API_URL).append("?s=").append(encode(cleaned))
append("&a=").append(encode(artist.primaryArtist()))
if (durationMs > 0) append("&d=").append(durationMs / 1000)
}
val body = get(url) ?: return@withContext null
val ttml = runCatching { JSONObject(body).optString("ttml") }.getOrNull()
?.takeIf { it.startsWith("<") } ?: return@withContext null
val parsed = Ttml.parse(ttml)
android.util.Log.i(
TAG,
"$cleaned: ${parsed?.lines?.size ?: 0} lines, " +
"${parsed?.lines?.count { it.words.isNotEmpty() } ?: 0} timed by word",
)
parsed?.takeIf { it.lines.isNotEmpty() }
}
/** Null on anything but a 200, which includes the 404 for "no match". */
private fun get(url: String): String? = runCatching {
val request = Request.Builder()
.url(url)
.header("Accept", "application/json")
.header("User-Agent", USER_AGENT)
.build()
http.newCall(request).execute().use { response ->
if (!response.isSuccessful) null else response.body?.string()?.takeIf(String::isNotBlank)
}
}.getOrNull()
private fun encode(value: String): String = URLEncoder.encode(value, "UTF-8")
private const val TAG = "BetterLyrics"
private const val API_URL = "https://lyrics-api.boidu.dev/getLyrics"
private const val USER_AGENT = "Square (Android music player)"
}