feat: add lyrics plugin
This commit is contained in:
h465855hgg
@@ -0,0 +1,486 @@
|
||||
--!nonstrict
|
||||
-- Lyrics — headless service.
|
||||
-- Polls MPRIS metadata via playerctl, fetches lyrics from NetEase Cloud Music
|
||||
-- via /api endpoints, publishes state. No polling delay.
|
||||
|
||||
noctalia.setUpdateInterval(250)
|
||||
|
||||
local cache = {}
|
||||
local coverCache = {}
|
||||
local lastTrackKey = ""
|
||||
local inFlight = nil
|
||||
local coverInFlight = nil
|
||||
local krcTmp = (noctalia.pluginDir() or "/tmp") .. "/.krc_cache.tmp"
|
||||
local lyricsSource = noctalia.getConfig("lyrics_source") or "auto"
|
||||
local customUrl = noctalia.getConfig("custom_url") or ""
|
||||
local customJsonField = noctalia.getConfig("custom_json_field") or "syncedLyrics"
|
||||
local currentTrack = nil
|
||||
local currentEmbeddedLyrics = ""
|
||||
|
||||
local function coverPathFor(track)
|
||||
local safe = (track.artist .. "_" .. track.album .. "_" .. track.title):gsub("[^%w]+", "_")
|
||||
return noctalia.pluginDir() .. "/cover_" .. safe .. ".jpg"
|
||||
end
|
||||
|
||||
local function shellQuote(value)
|
||||
return "'" .. tostring(value):gsub("'", "'\\''") .. "'"
|
||||
end
|
||||
|
||||
local function parseLRC(lrcText)
|
||||
local lines = {}
|
||||
for line in lrcText:gmatch("[^\n]+") do
|
||||
local mins, secs = line:match("%[(%d+):(%d+%.?%d*)%]")
|
||||
if mins and secs then
|
||||
local ms = math.floor(tonumber(mins) * 60000 + tonumber(secs) * 1000)
|
||||
local text = line:gsub("%[%d+:%d+%.?%d*%]", ""):gsub("^%s+", ""):gsub("%s+$", "")
|
||||
if text ~= "" then
|
||||
local isMeta = ms < 5000 and (text:find(":") or text:find("："))
|
||||
if not isMeta then
|
||||
lines[#lines + 1] = { time = ms, text = text }
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
if #lines == 0 then return nil end
|
||||
return lines
|
||||
end
|
||||
|
||||
local function parsePlain(text)
|
||||
local lines = {}
|
||||
local seenLyric = false
|
||||
for line in text:gmatch("[^\n]+") do
|
||||
local trimmed = line:gsub("^%s+", ""):gsub("%s+$", "")
|
||||
if trimmed ~= "" then
|
||||
if seenLyric then
|
||||
lines[#lines + 1] = { time = -1, text = trimmed }
|
||||
elseif trimmed:find(":") or trimmed:find("：") then
|
||||
-- skip metadata header line
|
||||
else
|
||||
seenLyric = true
|
||||
lines[#lines + 1] = { time = -1, text = trimmed }
|
||||
end
|
||||
end
|
||||
end
|
||||
if #lines == 0 then return nil end
|
||||
return lines
|
||||
end
|
||||
|
||||
local function evictCache()
|
||||
local keys = {}
|
||||
for k, _ in pairs(cache) do keys[#keys + 1] = k end
|
||||
if #keys > 30 then
|
||||
table.sort(keys)
|
||||
for i = 1, #keys - 30 do cache[keys[i]] = nil end
|
||||
end
|
||||
end
|
||||
|
||||
local function fetchLyricsNetEase(track, embeddedLyrics)
|
||||
if inFlight then return end
|
||||
inFlight = track
|
||||
|
||||
local tk = track.title .. "|" .. track.artist .. "|" .. track.album
|
||||
|
||||
local function tryFetch(query, fallback)
|
||||
local searchUrl = "https://music.163.com/api/search/get?type=1&s=" .. noctalia.string.urlEncode(query) .. "&limit=5"
|
||||
local cmd = 'curl -s --max-time 10 --connect-timeout 5 "' .. searchUrl .. '" -H "Referer: https://music.163.com"'
|
||||
|
||||
noctalia.runAsync(cmd, function(r1)
|
||||
if not inFlight then return end
|
||||
if tk ~= lastTrackKey then inFlight = nil; return end
|
||||
|
||||
if r1.exitCode ~= 0 or not r1.stdout or #r1.stdout == 0 then
|
||||
if fallback then fallback()
|
||||
else inFlight = nil; noctalia.state.set("lyrics", nil) end
|
||||
return
|
||||
end
|
||||
|
||||
local data = noctalia.json.decode(r1.stdout)
|
||||
if not data or not data.result or not data.result.songs or #data.result.songs == 0 then
|
||||
if fallback then fallback()
|
||||
else inFlight = nil; noctalia.state.set("lyrics", nil) end
|
||||
return
|
||||
end
|
||||
|
||||
local function songArtist(s)
|
||||
if s.artists and #s.artists > 0 then
|
||||
return (s.artists[1].name or ""):lower()
|
||||
end
|
||||
return ""
|
||||
end
|
||||
|
||||
local bestMatch = nil
|
||||
local trackArtist = track.artist:lower()
|
||||
for _, s in ipairs(data.result.songs) do
|
||||
if songArtist(s):find(trackArtist, 1, true) then
|
||||
bestMatch = s
|
||||
break
|
||||
end
|
||||
end
|
||||
if not bestMatch then
|
||||
bestMatch = data.result.songs[1]
|
||||
end
|
||||
|
||||
local songId = bestMatch.id
|
||||
local lyricUrl = "https://music.163.com/api/song/lyric?id=" .. songId .. "&lv=1&kv=1&tv=-1"
|
||||
local lCmd = 'curl -s --max-time 10 --connect-timeout 5 "' .. lyricUrl .. '" -H "Referer: https://music.163.com"'
|
||||
|
||||
noctalia.runAsync(lCmd, function(r2)
|
||||
if not inFlight then return end
|
||||
if tk ~= lastTrackKey then inFlight = nil; return end
|
||||
|
||||
local lyrics = nil
|
||||
if r2.exitCode == 0 and r2.stdout and #r2.stdout > 0 then
|
||||
local ldata = noctalia.json.decode(r2.stdout)
|
||||
local klyricStr = ""
|
||||
if ldata and ldata.klyric then
|
||||
local k = ldata.klyric
|
||||
if type(k) == "string" then
|
||||
klyricStr = k
|
||||
elseif type(k) == "table" then
|
||||
klyricStr = (k.lyric and type(k.lyric) == "string") and k.lyric or ""
|
||||
end
|
||||
end
|
||||
if klyricStr ~= "" then
|
||||
local ok = pcall(noctalia.writeFile, krcTmp, klyricStr)
|
||||
if not ok then klyricStr = "" end
|
||||
end
|
||||
if klyricStr ~= "" then
|
||||
local py = 'python3 "' .. noctalia.pluginDir() .. '/krc_decode.py" "' .. krcTmp .. '"'
|
||||
noctalia.runAsync(py, function(r3)
|
||||
if not inFlight then return end
|
||||
if tk ~= lastTrackKey then inFlight = nil; return end
|
||||
local ok, parsed = pcall(noctalia.json.decode, r3.stdout or "")
|
||||
if ok and parsed and parsed.type == "krc" and parsed.lines then
|
||||
cache[tk] = parsed.lines
|
||||
evictCache()
|
||||
inFlight = nil
|
||||
noctalia.state.set("lyrics", parsed.lines)
|
||||
return
|
||||
end
|
||||
local lrc = (ldata.lrc and ldata.lrc.lyric) or ""
|
||||
local lyr = parseLRC(lrc)
|
||||
if not lyr then lyr = parsePlain(lrc) end
|
||||
if lyr then
|
||||
cache[tk] = lyr
|
||||
evictCache()
|
||||
inFlight = nil
|
||||
noctalia.state.set("lyrics", lyr)
|
||||
elseif fallback then
|
||||
fallback()
|
||||
else
|
||||
inFlight = nil
|
||||
noctalia.state.set("lyrics", nil)
|
||||
end
|
||||
end)
|
||||
return
|
||||
end
|
||||
if ldata and ldata.lrc and ldata.lrc.lyric and ldata.lrc.lyric ~= "" then
|
||||
lyrics = parseLRC(ldata.lrc.lyric)
|
||||
if not lyrics then
|
||||
lyrics = parsePlain(ldata.lrc.lyric)
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
if lyrics then
|
||||
cache[tk] = lyrics
|
||||
evictCache()
|
||||
inFlight = nil
|
||||
noctalia.state.set("lyrics", lyrics)
|
||||
elseif fallback then
|
||||
fallback()
|
||||
else
|
||||
inFlight = nil
|
||||
noctalia.state.set("lyrics", nil)
|
||||
end
|
||||
end)
|
||||
end)
|
||||
end
|
||||
|
||||
local query = track.title .. "\n" .. track.artist .. "\n" .. (track.album or "")
|
||||
local qTmp = (noctalia.pluginDir() or "/tmp") .. "/.query_cache.tmp"
|
||||
noctalia.writeFile(qTmp, query)
|
||||
local dir = noctalia.pluginDir() or "/tmp"
|
||||
|
||||
local function applyParsed(parsed)
|
||||
if parsed and parsed.type == "krc" and parsed.lines then
|
||||
cache[tk] = parsed.lines
|
||||
evictCache()
|
||||
noctalia.state.set("lyrics", parsed.lines)
|
||||
return true
|
||||
end
|
||||
if parsed and parsed.type == "lrc" and parsed.lrc and parsed.lrc ~= "" then
|
||||
local lyr = parseLRC(parsed.lrc)
|
||||
if not lyr then lyr = parsePlain(parsed.lrc) end
|
||||
if lyr then
|
||||
cache[tk] = lyr
|
||||
evictCache()
|
||||
noctalia.state.set("lyrics", lyr)
|
||||
return true
|
||||
end
|
||||
end
|
||||
return false
|
||||
end
|
||||
|
||||
local function runPy(script, cb)
|
||||
local py = 'python3 "' .. dir .. "/" .. script .. '" "' .. qTmp .. '"'
|
||||
noctalia.runAsync(py, function(r)
|
||||
if not inFlight then return end
|
||||
if tk ~= lastTrackKey then inFlight = nil; return end
|
||||
local ok, parsed = pcall(noctalia.json.decode, r.stdout or "")
|
||||
cb(ok and parsed or nil)
|
||||
end)
|
||||
end
|
||||
|
||||
local function applyText(text)
|
||||
if not text or text == "" then return false end
|
||||
local parsed = parseLRC(text)
|
||||
if not parsed then parsed = parsePlain(text) end
|
||||
if not parsed then return false end
|
||||
cache[tk] = parsed
|
||||
evictCache()
|
||||
noctalia.state.set("lyrics", parsed)
|
||||
return true
|
||||
end
|
||||
|
||||
local function fetchCustom()
|
||||
if customUrl == "" then
|
||||
inFlight = nil
|
||||
noctalia.state.set("lyrics", nil)
|
||||
return
|
||||
end
|
||||
|
||||
local replacements = {
|
||||
title = track.title,
|
||||
artist = track.artist,
|
||||
album = track.album,
|
||||
duration = tostring(math.floor((track.duration or 0) / 1000000)),
|
||||
}
|
||||
local url = customUrl:gsub("{([%w_]+)}", function(key)
|
||||
return noctalia.string.urlEncode(replacements[key] or "")
|
||||
end)
|
||||
|
||||
noctalia.http({ url = url, headers = { "Accept: application/json, text/plain" } }, function(response)
|
||||
if tk ~= lastTrackKey then inFlight = nil; return end
|
||||
local text = response.ok and response.body or ""
|
||||
if text ~= "" and customJsonField ~= "" then
|
||||
local decoded = noctalia.json.decode(text)
|
||||
for part in customJsonField:gmatch("[^.]+") do
|
||||
decoded = type(decoded) == "table" and decoded[part] or nil
|
||||
end
|
||||
if type(decoded) == "table" then
|
||||
cache[tk] = decoded
|
||||
evictCache()
|
||||
noctalia.state.set("lyrics", decoded)
|
||||
inFlight = nil
|
||||
return
|
||||
end
|
||||
text = type(decoded) == "string" and decoded or ""
|
||||
end
|
||||
applyText(text)
|
||||
inFlight = nil
|
||||
end)
|
||||
end
|
||||
|
||||
if lyricsSource == "external" then
|
||||
inFlight = nil
|
||||
return
|
||||
elseif lyricsSource == "mpris" then
|
||||
applyText(embeddedLyrics)
|
||||
inFlight = nil
|
||||
return
|
||||
elseif lyricsSource == "custom" then
|
||||
fetchCustom()
|
||||
return
|
||||
elseif lyricsSource == "netease" then
|
||||
tryFetch(track.title .. " " .. track.artist, function()
|
||||
tryFetch(track.title, nil)
|
||||
end)
|
||||
return
|
||||
end
|
||||
|
||||
-- Auto: LRCLIB, then the public NetEase API.
|
||||
runPy("lrclib_lyric.py", function(parsed)
|
||||
if applyParsed(parsed) then inFlight = nil; return end
|
||||
if lyricsSource == "lrclib" then
|
||||
inFlight = nil
|
||||
noctalia.state.set("lyrics", nil)
|
||||
return
|
||||
end
|
||||
tryFetch(track.title .. " " .. track.artist, function()
|
||||
tryFetch(track.title, nil)
|
||||
end)
|
||||
end)
|
||||
end
|
||||
|
||||
local function fetchCover(track, artUrl)
|
||||
if coverInFlight then return end
|
||||
coverInFlight = track.title .. "|" .. track.artist .. "|" .. track.album
|
||||
|
||||
local dest = coverPathFor(track)
|
||||
|
||||
local apply = function(path)
|
||||
local tk = track.title .. "|" .. track.artist .. "|" .. track.album
|
||||
coverInFlight = nil
|
||||
if tk ~= lastTrackKey then return end
|
||||
coverCache[tk] = path
|
||||
noctalia.state.set("cover", path)
|
||||
end
|
||||
|
||||
if not artUrl or artUrl == "" then
|
||||
noctalia.state.set("cover", nil)
|
||||
coverInFlight = nil
|
||||
return
|
||||
end
|
||||
|
||||
if artUrl:sub(1, 7) == "file://" then
|
||||
local source = noctalia.string.urlDecode(artUrl:sub(8))
|
||||
if not noctalia.fileExists(source) then
|
||||
apply(nil)
|
||||
return
|
||||
end
|
||||
noctalia.runAsync("cp -- " .. shellQuote(source) .. " " .. shellQuote(dest), function(result)
|
||||
if result.exitCode == 0 then apply(dest) else apply(source) end
|
||||
end)
|
||||
return
|
||||
end
|
||||
|
||||
noctalia.download(artUrl, dest, function(ok)
|
||||
if ok then apply(dest) else apply(nil) end
|
||||
end)
|
||||
end
|
||||
|
||||
local function poll()
|
||||
local cmd = [[playerctl metadata --format $'{{lc(status)}}\x1f{{title}}\x1f{{artist}}\x1f{{album}}\x1f{{position}}\x1f{{mpris:length}}\x1f{{mpris:artUrl}}\x1f{{xesam:asText}}' 2>/dev/null]]
|
||||
|
||||
noctalia.runAsync(cmd, function(r)
|
||||
if r.exitCode ~= 0 or not r.stdout or r.stdout == "" then
|
||||
noctalia.state.set("track", nil)
|
||||
noctalia.state.set("lyrics", nil)
|
||||
noctalia.state.set("cover", nil)
|
||||
noctalia.state.set("playing", false)
|
||||
return
|
||||
end
|
||||
|
||||
local parts = {}
|
||||
local separator = string.char(31)
|
||||
for field in (r.stdout .. separator):gmatch("(.-)" .. separator) do
|
||||
parts[#parts + 1] = field:gsub("^%s+", ""):gsub("%s+$", "")
|
||||
end
|
||||
|
||||
local status = parts[1] or "stopped"
|
||||
local title = parts[2] or ""
|
||||
local artist = parts[3] or ""
|
||||
local album = parts[4] or ""
|
||||
local artUrl = parts[7] or ""
|
||||
local embeddedLyrics = parts[8] or ""
|
||||
|
||||
if title == "" and artist == "" then
|
||||
noctalia.state.set("track", nil)
|
||||
noctalia.state.set("lyrics", nil)
|
||||
noctalia.state.set("playing", status == "playing")
|
||||
return
|
||||
end
|
||||
|
||||
local playing = status == "playing"
|
||||
local tk = title .. "|" .. artist .. "|" .. album
|
||||
|
||||
local t = {
|
||||
title = title,
|
||||
artist = artist,
|
||||
album = album,
|
||||
status = status,
|
||||
position = tonumber(parts[5]) or 0,
|
||||
duration = tonumber(parts[6]) or 0,
|
||||
}
|
||||
currentTrack = t
|
||||
currentEmbeddedLyrics = embeddedLyrics
|
||||
|
||||
noctalia.state.set("position", t.position)
|
||||
|
||||
if tk ~= lastTrackKey then
|
||||
lastTrackKey = tk
|
||||
noctalia.state.set("track", t)
|
||||
noctalia.state.set("playing", playing)
|
||||
|
||||
local cached = cache[tk]
|
||||
if cached then
|
||||
noctalia.state.set("lyrics", cached)
|
||||
else
|
||||
noctalia.state.set("lyrics", nil)
|
||||
fetchLyricsNetEase(t, embeddedLyrics)
|
||||
end
|
||||
|
||||
local cachedCover = coverCache[tk]
|
||||
if cachedCover then
|
||||
noctalia.state.set("cover", cachedCover)
|
||||
else
|
||||
noctalia.state.set("cover", nil)
|
||||
fetchCover(t, artUrl)
|
||||
end
|
||||
else
|
||||
noctalia.state.set("track", t)
|
||||
noctalia.state.set("playing", playing)
|
||||
end
|
||||
end)
|
||||
end
|
||||
|
||||
local pollTick = 0
|
||||
|
||||
function update()
|
||||
if lyricsSource == "external" then return end
|
||||
pollTick = pollTick + 1
|
||||
if pollTick % 2 == 0 then
|
||||
poll()
|
||||
end
|
||||
|
||||
end
|
||||
|
||||
function onConfigChanged()
|
||||
local nextSource = noctalia.getConfig("lyrics_source") or "auto"
|
||||
local nextUrl = noctalia.getConfig("custom_url") or ""
|
||||
local nextField = noctalia.getConfig("custom_json_field") or "syncedLyrics"
|
||||
local sourceChanged = nextSource ~= lyricsSource or nextUrl ~= customUrl or nextField ~= customJsonField
|
||||
lyricsSource = nextSource
|
||||
customUrl = nextUrl
|
||||
customJsonField = nextField
|
||||
if sourceChanged and currentTrack then
|
||||
inFlight = nil
|
||||
cache = {}
|
||||
noctalia.state.set("lyrics", nil)
|
||||
fetchLyricsNetEase(currentTrack, currentEmbeddedLyrics)
|
||||
end
|
||||
end
|
||||
|
||||
local function applyPushedLyrics(payload)
|
||||
local decoded = noctalia.json.decode(payload or "")
|
||||
if type(decoded) == "table" then
|
||||
if decoded.track then
|
||||
currentTrack = decoded.track
|
||||
lastTrackKey = (decoded.track.title or "") .. "|" .. (decoded.track.artist or "") .. "|" .. (decoded.track.album or "")
|
||||
noctalia.state.set("track", decoded.track)
|
||||
end
|
||||
if decoded.lines then noctalia.state.set("lyrics", decoded.lines) end
|
||||
if decoded.lyrics then
|
||||
local parsed = parseLRC(decoded.lyrics) or parsePlain(decoded.lyrics)
|
||||
noctalia.state.set("lyrics", parsed)
|
||||
end
|
||||
if decoded.position ~= nil then noctalia.state.set("position", decoded.position) end
|
||||
if decoded.playing ~= nil then noctalia.state.set("playing", decoded.playing == true) end
|
||||
if decoded.cover ~= nil then noctalia.state.set("cover", decoded.cover) end
|
||||
return true
|
||||
end
|
||||
return false
|
||||
end
|
||||
|
||||
function onIpc(event, payload)
|
||||
if event == "push-lrc" then
|
||||
noctalia.state.set("lyrics", parseLRC(payload or "") or parsePlain(payload or ""))
|
||||
elseif event == "push-json" or event == "push-state" then
|
||||
applyPushedLyrics(payload)
|
||||
elseif event == "clear" then
|
||||
noctalia.state.set("lyrics", nil)
|
||||
end
|
||||
end
|
||||
|
||||
if lyricsSource ~= "external" then poll() end
|
||||
Reference in New Issue
Block a user