starred/koel-koel

Fork 0

mirror of https://github.com/koel/koel.git synced 2026-04-26 09:15:59 +03:00

[GH-ISSUE #2176] [Bug]: Lyrics embedded in FLAC files not working #1112

New issue

Closed

opened 2026-02-26 02:35:17 +03:00 by kerem · 1 comment

kerem commented

2026-02-26 02:35:17 +03:00

Owner

Originally created by @tywil04 on GitHub (Dec 10, 2025).
Original GitHub issue: https://github.com/koel/koel/issues/2176

Originally assigned to: @phanan on GitHub.

Read the Troubleshooting guide.

I have read and followed the Troubleshooting guide

Reproduction steps

Have a library of FLACs with embedded lyrics

Expected behavior

Lyrics are shown in the lyrics tab in the web interface

Actual behavior

The lyrics tab in the web interface says "No lyrics found. to add lyrics."

I can confirm that my FLAC files have embedded lyrics, I have checked with the metaflac tool and there is a VORBIS comment called LYRICS with the correct lyrics for each song.

Logs

No errors in logs or browser console.

Koel version

v8.1.0

How did you install Koel?

Official Docker image

Additional information

Server OS: AlmaLinux
PHP version: Whatever version the latest docker image uses
Database: Postgres
Node version: Whatever version the latest docker image uses
Browser & device: Firefox, MacOS and Chrome MacOS
Additional context: From my understanding (searching around for existing issues, etc.), I think koel is supposed to support pulling embedded lyrics from FLAC files, but I am unsure.

Originally created by @tywil04 on GitHub (Dec 10, 2025). Original GitHub issue: https://github.com/koel/koel/issues/2176 Originally assigned to: @phanan on GitHub. ### Read the Troubleshooting guide. - [x] I have read and followed the Troubleshooting guide ### Reproduction steps Have a library of FLACs with embedded lyrics ### Expected behavior Lyrics are shown in the lyrics tab in the web interface ### Actual behavior The lyrics tab in the web interface says "No lyrics found. to add lyrics." I can confirm that my FLAC files have embedded lyrics, I have checked with the `metaflac` tool and there is a VORBIS comment called LYRICS with the correct lyrics for each song. ### Logs No errors in logs or browser console. ### Koel version v8.1.0 ### How did you install Koel? Official Docker image ### Additional information - **Server OS**: AlmaLinux - **PHP version**: Whatever version the latest docker image uses - **Database**: Postgres - **Node version**: Whatever version the latest docker image uses - **Browser & device**: Firefox, MacOS and Chrome MacOS - **Additional context**: From my understanding (searching around for existing issues, etc.), I think koel is supposed to support pulling embedded lyrics from FLAC files, but I am unsure.

kerem closed this issue

2026-02-26 02:35:17 +03:00

kerem commented

2026-02-26 02:35:17 +03:00

Author

Owner

@ngiamour commented on GitHub (Dec 15, 2025):

Hi there! 👋.
I investigated this issue and i think i found the cause. It seems the scanner was missing the vorbiscomment tags (used by FLAC) and wasn't checking for the standard LYRICS tag key. I've tested to solution locally and it works as expected! I've sent a pull request. Could you accept it, if there is no problem with it ?

@ngiamour commented on GitHub (Dec 15, 2025): Hi there! 👋. I investigated this issue and i think i found the cause. It seems the scanner was missing the vorbiscomment tags (used by FLAC) and wasn't checking for the standard LYRICS tag key. I've tested to solution locally and it works as expected! I've sent a pull request. Could you accept it, if there is no problem with it ?

kerem referenced this issue

2026-02-26 03:31:33 +03:00

[PR #1112] [MERGED] Bump phpunit/phpunit from 7.5.16 to 7.5.17 #1583

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

starred/koel-koel#1112

No description provided.

Rows
Columns