[GH-ISSUE #2035] [FR]: star ratings #1073

Open
opened 2026-02-26 02:35:09 +03:00 by kerem · 5 comments
Owner

Originally created by @realrolfje on GitHub (Jul 26, 2025).
Original GitHub issue: https://github.com/koel/koel/issues/2035

Originally assigned to: @phanan on GitHub.

Description

Hi, thanks for creating Koel. I'd really like to have a star rating (0 to 5 stars) per Song in Koel.

Additional information

I used to have the following setup in iTunes and I am looking to reproduce that so I can quickly go through new music, while also weeding out lesser songs while keeping albums complete:

I rate my songs as follows:
1 star -> never play again
2 star -> maybe reconsider
3 star -> normal song, please play this
4 star -> good song, play more often
5 star -> awesome song, no problem if this is on constant repeat

Smart playlists:

  • No stars: New music playlist, I use this to go through music I haven't heard or rated yet
  • 3 stars: Can be used as radio
  • 4 stars and higher: good songs quickpicks

Quickly tapping a star on a song makes the whole mechanics work, and filters my entire library quickly. Of course I still make fixed playlists like "easy listening", "rock" or "house", but that can be quick because I can weed out the songs with 2 or less stars.

Originally created by @realrolfje on GitHub (Jul 26, 2025). Original GitHub issue: https://github.com/koel/koel/issues/2035 Originally assigned to: @phanan on GitHub. ### Description Hi, thanks for creating Koel. I'd really like to have a star rating (0 to 5 stars) per Song in Koel. ### Additional information I used to have the following setup in iTunes and I am looking to reproduce that so I can quickly go through new music, while also weeding out lesser songs while keeping albums complete: I rate my songs as follows: 1 star -> never play again 2 star -> maybe reconsider 3 star -> normal song, please play this 4 star -> good song, play more often 5 star -> awesome song, no problem if this is on constant repeat Smart playlists: - No stars: New music playlist, I use this to go through music I haven't heard or rated yet - 3 stars: Can be used as radio - 4 stars and higher: good songs quickpicks Quickly tapping a star on a song makes the whole mechanics work, and filters my entire library quickly. Of course I still make fixed playlists like "easy listening", "rock" or "house", but that can be quick because I can weed out the songs with 2 or less stars.
Author
Owner

@phanan commented on GitHub (Jul 26, 2025):

This is a useful feature indeed :)

<!-- gh-comment-id:3122185139 --> @phanan commented on GitHub (Jul 26, 2025): This is a useful feature indeed :)
Author
Owner

@t-MURO commented on GitHub (Oct 10, 2025):

@realrolfje just wanted to tell you that star rating is so messed up. If you have your iTunes music rated, you definitively won't see it in Koel. It's not some sort of standard like title, track number, artist name, etc. First time I moved a song from iTunes to some other music player the rating was not visible. I wrote a tool or used some software that gave me the metadata. I saw that the rating was saved as something like { iTunes: 3.5 } . So if you try to read the field you don't get a straight value. Maybe if you also rate it on another program it will be { iTunes: 3.5, ProgramX: 35 }. Pretty inconsistent. That's what I have in memory though

<!-- gh-comment-id:3388743889 --> @t-MURO commented on GitHub (Oct 10, 2025): @realrolfje just wanted to tell you that star rating is so messed up. If you have your iTunes music rated, you definitively won't see it in Koel. It's not some sort of standard like title, track number, artist name, etc. First time I moved a song from iTunes to some other music player the rating was not visible. I wrote a tool or used some software that gave me the metadata. I saw that the rating was saved as something like `{ iTunes: 3.5 }` . So if you try to read the field you don't get a straight value. Maybe if you also rate it on another program it will be `{ iTunes: 3.5, ProgramX: 35 }`. Pretty inconsistent. That's what I have in memory though
Author
Owner

@realrolfje commented on GitHub (Oct 10, 2025):

It is indeed surprising to see that all these smart developers who can code stream transcoders seem to be unable to read or let alone convert a simple 5 star rating everyone uses. ...or have the arrogance of thinking "users don't need it" is enough reason to remove the simplest and most effective rating system ever 😉

<!-- gh-comment-id:3390933714 --> @realrolfje commented on GitHub (Oct 10, 2025): It is indeed surprising to see that all these smart developers who can code stream transcoders seem to be unable to read or let alone convert a simple 5 star rating everyone uses. ...or have the arrogance of thinking "users don't need it" is enough reason to remove the simplest and most effective rating system ever 😉
Author
Owner

@t-MURO commented on GitHub (Oct 10, 2025):

Btw what I said was wrong. iTunes actually doesn't even store the rating in the music files themselves. I got confused and what I found was a rating from a different media player. The official rating for mp3 files POPM or popularimeter. The format is email|rating|playbackcount
I don't really know why the first is called email. It's actually just a string. The rating is a value from 0-255 lol. And for whatever the reason the play count is included there as well.
If you own a windows PC or can spin up a VM I would recommend installing iTunes and copying your library + the big xml file. Then install MusicBee and use the import from iTunes function. You will have all playlists and ratings. I don't remember if you need to explicitly enable it but the ratings can be saved in the music files. You can then replace all the songs with the ones that have the rating embedded on your mac.
Of course when you open it with another music player it might not show up but I think there are tools that can read the POPM value and append other common rating systems (media monkey, winamp, windows media player) and those are often recognized by various media players.
I wish I could give you a better answer but it's something I'm working on right now...

<!-- gh-comment-id:3391063581 --> @t-MURO commented on GitHub (Oct 10, 2025): Btw what I said was wrong. iTunes actually doesn't even store the rating in the music files themselves. I got confused and what I found was a rating from a different media player. The official rating for mp3 files POPM or popularimeter. The format is email|rating|playbackcount I don't really know why the first is called email. It's actually just a string. The rating is a value from 0-255 lol. And for whatever the reason the play count is included there as well. If you own a windows PC or can spin up a VM I would recommend installing iTunes and copying your library + the big xml file. Then install MusicBee and use the import from iTunes function. You will have all playlists and ratings. I don't remember if you need to explicitly enable it but the ratings can be saved in the music files. You can then replace all the songs with the ones that have the rating embedded on your mac. Of course when you open it with another music player it might not show up but I think there are tools that can read the POPM value and append other common rating systems (media monkey, winamp, windows media player) and those are often recognized by various media players. I wish I could give you a better answer but it's something I'm working on right now...
Author
Owner

@realrolfje commented on GitHub (Oct 10, 2025):

I really appreciate the effort and I hope that this thread will help someone with a similar problem. For me it is too late as my itunes library was 100% local and after I gave up I kept it around for a few years hoping to write a conversion script myself but never got to it. The machine is now gone and I have no backups of that drive (to my big frustration, I thought I had it but I didn't).

So now I'm stuck with Spotify and am looking to rebuild my itunes library from scratch in a more future proof format but that takes months of re-ripping CD's and re-rating them. First world problems 🙂

<!-- gh-comment-id:3391206218 --> @realrolfje commented on GitHub (Oct 10, 2025): I really appreciate the effort and I hope that this thread will help someone with a similar problem. For me it is too late as my itunes library was 100% local and after I gave up I kept it around for a few years hoping to write a conversion script myself but never got to it. The machine is now gone and I have no backups of that drive (to my big frustration, I thought I had it but I didn't). So now I'm stuck with Spotify and am looking to rebuild my itunes library from scratch in a more future proof format but that takes months of re-ripping CD's and re-rating them. First world problems 🙂
Sign in to join this conversation.
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#1073
No description provided.