Changelog

Notable changes to the API and to the Braccato packages. Braccato entries are pulled from each package's changelog when this site is built.

API

2026-03-08 Added the QQ provider at /qq/getLyrics, which returns QRC with word-level timing.
2026-01-07 Cached and negatively cached entries now match within a small duration tolerance, so d does not have to be exact.
2025-12-08 Introduced API keys for fresh fetches. Cached responses stay free and need no key.
2025-10-31 Added the d (duration) parameter to improve matching.

Keep lines from piling on top of each other when the view scrolls far, such as clicking an older line, seeking, opening lyrics mid-song, or returning from a manual scroll. Natural line-to-line advances keep the theme's stagger exactly.

A host that drives the clock without player snapshots, such as an audio element looping a range shorter than half a second, no longer leaves upcoming lines sweeping from the clock before each pass.

A host that keeps playing through a seek, such as a looped audio element, no longer leaves the next line sweeping from the clock before the jump.

Clicking a line or Alt-clicking a word now seeks to where it plays when lyric offsets or trims are set, instead of to its unshifted time.

LRC and enhanced LRC now get instrumental lines on the same terms as TTML. Blank and music-note lines no longer render as empty rows: they end the line before them, and a silence longer than instrumentalGapMs (now an option on parseLRC) becomes an instrumental, including the intro and the outro. A closing word timestamp in enhanced LRC ends the line there instead of opening an empty part.

Add @braccato/highlight, and expose format detection as @braccato/parsers/format

LRC reads songwriters from timed credit lines such as 作词： or Written by:, in plain and enhanced LRC, and keeps credit lines out of the parsed lyrics the way QRC does. Both parsers now recognise Traditional Chinese roles and joined or tagged roles such as 作曲/编曲, 作詞・作曲 and Rap作词, and no longer take a sung line ending in a role noun for a credit.

Read songwriters from TTML, LRC and QRC files with parser.metadata(), pass them through every provider as songwriters, and close the lyrics view with a "Written by" line that brightens and takes the scroll focus once the song ends.

Keep the parentheses around LySy background vocals instead of dropping them, so background text renders the way the source wrote it.

Dim background vocals in the editor, where they can no longer be italic, so they still stand apart from the main lyrics. The new --bh-bgText-editor property sets their colour (default rgba(255, 255, 255, 0.65)).

The editor overlay now wraps exactly like its textarea: each layer line is one text node coloured through the CSS Custom Highlight API instead of a span per token, so edits no longer land a line away from the colours. Background vocals and comments lose their italics in the editor, and one-line documents cost more paint per keystroke.

Keep the editor overlay on the textarea's rows while editing a scrolled document. Chrome's scroll anchoring moved the overlay up a row whenever an edit removed a row near the top of the view, but the textarea did not move, so the colours showed one or more lines above the caret and the text under the caret looked like a different line.

Keep the editor overlay's colours on the textarea's text in long, wrapped documents. A unitless line-height such as 1.7 is now copied as written instead of as its resolved pixel value, which Chrome rounds to a slightly different row height, so the colours no longer creep down by a fraction of a pixel per row (about 5 px by line 160 at 12px/1.7). When a page shows the textarea's scrollbar, the overlay now leaves the same space for it, so both wrap at the same width; previously every line that wrapped differently pushed the colours down another row.

tokenize now returns the tokens the built-in renderers draw: adjacent tokens of the same type are joined into one, so a renderer of your own reproduces highlightInto exactly with no merging step. Code that relied on the finer split (for example a separate text token for each newline, or ] and [ as two punct tokens) sees fewer, longer tokens. The editor handle gains setFormat(format?), which changes the format of a live editor without re-attaching, so the textarea keeps its undo history. The editor now copies its options at attach time; later writes to the options object are ignored.

Read songwriters from TTML, LRC and QRC files with parser.metadata(), pass them through every provider as songwriters, and close the lyrics view with a "Written by" line that brightens and takes the scroll focus once the song ends.