Dictionary

What Are Lyrics?

The Lyrics field stores the words of a song as text inside an audio or video file, in some formats with a language code. In ffprobe, Lyrics can also be a 0 or 1 flag.

lyrics

Lyrics are the words of a song. In metadata, the Lyrics field holds those words as text inside an audio or video file. A report from ffprobe can also show a Lyrics flag.

The ID3v2 standard describes the text field as the lyrics of a song or a text transcription of other vocal activities. The text is stored apart from the sound, so you can only read it with software that reads this field.

Which files carry it

Each file format stores lyrics under its own field name. These are the names in the common formats:

  • MP3: the ID3v2 frames USLT for plain text and SYLT for timed text.
  • WAV and AIFF: the same ID3v2 frames, if the file contains an ID3 tag.
  • FLAC and OGG: a Vorbis comment. MusicBrainz Picard names it LYRICS, but no specification fixes the name.
  • M4A and MP4: the metadata item ©lyr.
  • MKV: the Matroska tag LYRICS.
  • WMA and WMV: the attributes WM/Lyrics and WM/Lyrics_Synchronised.

Plain and synchronized lyrics

Plain lyrics are one block of text with no timing. Synchronized lyrics link each piece of text to a moment in the recording. Software can then show the words in time with the sound, for example for karaoke.

In an ID3v2 SYLT frame, each piece of text has a time stamp. The time stamp counts from the start of the file, in milliseconds or MPEG frames.

What the value looks like

A plain value is ordinary text, and the text can contain line breaks. For synchronized text, ExifTool puts a time stamp in square brackets before each entry: [MM:SS.ss] for seconds, or [FFFF] for MPEG frames.

A file can hold lyrics in more than one language. In ID3v2, each USLT or SYLT frame has a 3-letter language field that follows ISO 639-2. These are example values:

  • eng for English
  • deu or ger for German
  • XXX when the language is not known, as the ID3v2 text says

For an ID3v2 USLT frame with no description, FFmpeg adds the language code to the key, as in lyrics-eng for English text. For an unknown language, FFmpeg 9.0 shows lyrics-XXX, and its development code shows plain lyrics. ExifTool uses the same pattern for a chosen language, as in Lyrics-eng.

Lyrics as a stream flag

In a report from ffprobe, the file reader of the FFmpeg project, Lyrics can also be a stream flag, either 0 or 1. FFmpeg documents it in a few words: the stream contains song lyrics. The flag holds no words.

The -show_streams option of the ffprobe reader prints this flag for each stream, next to the Karaoke flag. So you can see 0 in a file with no music. A 0 does not prove that the file has no lyrics text.

Where the text comes from

The Lyrics text does not come from the sound itself. A person or a program has to add the text.

Tagging software can write the field. MusicBrainz Picard needs a plugin or a script for the text, because its database holds no lyrics.

Conversion can carry the text into a new file. FFmpeg copies global metadata from the first input file by default. So a converted file can keep the Lyrics text of its source, even if you never tagged that file yourself.

Why it matters for your file

The Lyrics text field can hold the full text of a song. When you share the file, you also share this text, even if a player never shows the text.

A missing text field tells you nothing about the song. A song with words can have no Lyrics text. The text can also differ from what you hear.

One file can show several Lyrics values, for example plain and synchronized text, or text in 2 languages. In a Matroska file, the LYRICS tag can also duplicate a subtitle track. The specification says you should generally edit both.