feat: per-track loudness normalization and server audio info
CI / chart (push) Successful in 3s
CI / test (push) Successful in 2m6s
CI / chart-push (push) Successful in 3s
CI / image (push) Successful in 3m31s

- measure downloads with ffmpeg's EBU R128 filter and store gain/LUFS
- backfill the existing library one file at a time
- expose gain on songs and a /info endpoint for source quality
- chart knobs LOUDNESS_ENABLED and LOUDNESS_TARGET_LUFS
This commit is contained in:
TapTap committed 2026-11-19 16:38:21 +00:00
1 parent 6763a83b03
commit 91312faa1c
15 files changed
+387 -9

No files matched your search

@@ -89,6 +89,12 @@ class ApiRoutesTest {
val me = parse(client.get("/api/v1/me") { bearer(token) }.bodyAsText())
assertEquals("alice", me.string("name"))
val info = parse(client.get("/api/v1/info") { bearer(token) }.bodyAsText())
assertEquals("deezer", info.string("defaultSource"))
assertEquals(0, info["deezerQuality"]!!.jsonPrimitive.int)
assertTrue(info["loudnessEnabled"]!!.jsonPrimitive.content.toBoolean())
assertEquals("-16.0", info["loudnessTargetLufs"]!!.jsonPrimitive.content)
val malformed = client.post("/api/v1/moods") {
bearer(token)
contentType(ContentType.Application.Json)
@@ -635,6 +641,9 @@ class ApiRoutesTest {
mediaStore = seed.media,
gc = seed.gc,
defaultSource = defaultSource,
deezerQuality = 0,
loudnessEnabled = true,
loudnessTargetLufs = -16.0,
startScan = { false },
scanStatus = { ScanStatus(false, 0) },
)
@@ -0,0 +1,53 @@
package win.taptap.musicmanager.media
import kotlin.test.Test
import kotlin.test.assertEquals
import kotlin.test.assertNull
class LoudnessAnalyzerTest {
@Test
fun `parses the loudnorm summary`() {
val output = """
[Parsed_loudnorm_0 @ 0x1]
{
"input_i" : "-9.42",
"input_tp" : "-0.21",
"input_lra" : "6.10",
"output_i" : "-16.00"
}
""".trimIndent()
val measurement = LoudnessAnalyzer.parse(output)
assertEquals(-9.42, measurement?.lufs)
assertEquals(-0.21, measurement?.truePeakDb)
}
@Test
fun `gain targets minus sixteen lufs`() {
val analyzer = LoudnessAnalyzer(targetLufs = -16.0, truePeakDb = -1.5)
assertEquals(-6.6, analyzer.gainFor(LoudnessAnalyzer.Measurement(-9.4, -3.0)))
}
@Test
fun `gain is limited by the true peak ceiling`() {
val analyzer = LoudnessAnalyzer(targetLufs = -16.0, truePeakDb = -1.5)
// The loudness target would need +6 dB, but the peak only allows +1.5.
assertEquals(1.5, analyzer.gainFor(LoudnessAnalyzer.Measurement(-22.0, -3.0)))
}
@Test
fun `silence is left alone`() {
val analyzer = LoudnessAnalyzer()
assertEquals(0.0, analyzer.gainFor(LoudnessAnalyzer.Measurement(-70.0, -70.0)))
}
@Test
fun `missing summary is ignored`() {
assertNull(LoudnessAnalyzer.parse("ffmpeg: no such file"))
}
}