This is a collection of testcase mp3-files with embedded synchronized lyrics (aka SYLT tag). This set was initially built to verify that Lollypop player handles such lyrics correctly, hence the repository also contains a script to test it, but it might be useful for other projects as well.

Requirements

• mutagen - to generate tests
• lollypop - to test lollypop

How to use

All the testcases in the repository can be generated from the countdown.mp3 with:

python ./generate-tests.py

The lollypop implementation can be tested with:

PYTHONPATH="</path/to/lollpop>" python lollypop.test.py

To print lyric parsed by lollypop for a specific file run:

PYTHONPATH="</path/to/lollpop>" python lollypop.test.py </path/to/file.mp3>

To test lollypop manually:

• Open lollypop
• Under the three dots button at the bottom of the (left) side panel; tick lyrics
• Open a test file in the lollypop
• Switch to the lyrics tab on the side panel

List of testcases

• countdown - the original file from the Christian Weiske's blog. The file doesn't include the SYLT tag, but All the tests are generated based upon it.

Encoding tests:

• iso-nodesc - just a simple most basic latin1 lyrics id3v2.3
• iso-desc - lyrics track with nonempty description id3v2.3
• utf16-nodesc - utf-16-encoded lyrics without description id3v2.3
• utf16be-desc - utf-16be-encoded lyrics with description
• utf8-nodesc - utf-8-encoded lyrics without description
• utf8-desc - utf-8-encoded lyrics with description

Various endline configuration tests

• endline-reverse - endlines are located at the end of the lyrics instead of the beginning
• extra-line-start - an additional endline is added at the end of the lyrics
• extra-line-end - an additional endline is added at the beginning of the lyrics
• extra-line-mid - an additional endline is added at the middle (as a e.g. a verse separator)
• karaoke - karaoke-style lyrics i.e. each word is time-codded with multiple words per line
• multiline - some lyrics entries have several lines

See also

• Christian Weiske's blog, where he describes the current state of the SYLT support. Many thanks to him for that article.
• SYLT description in id3v2.3 and id3v2.4(in taglib repository) specs

Copying

The countdown.mp3 and all its derivatives are licensed under CC by-SA 4.0. Original recording was created by: tim.kahn and modified by Christian Weiske.

All the code in the repository is licensed under WTFPL.