Skip to content

Commit

Permalink
update desc
Browse files Browse the repository at this point in the history
  • Loading branch information
AF-1 committed May 1, 2024
1 parent c491b5f commit f24829c
Showing 1 changed file with 2 additions and 2 deletions.
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,7 +103,7 @@ You can install an [**applet**](https://github.com/AF-1#applets) on your *piCore
## FAQ
<details><summary>»<b>What rating scale does this plugin use?</b>«<br>&nbsp;&nbsp;&nbsp;&nbsp;»<b>Can I use / disable <i>half-star</i> ratings?</b>«</summary><br><p>Rating values are stored in the <i>tracks_persistent</i> database table provided by LMS. <b>Internal rating values in LMS</b> can range <b>from 0 (no stars) to 100 (5 stars) where 20 equals 1 star</b> (40 = 2 stars, 50 = 2.5 stars etc.). So how rating values are stored in LMS is a default that cannot be changed.<br><br><i>Ratings Light</i> will <i>always</i> <b><u>display</u> the exact half-star value</b> on a <b>5</b>-star rating scale (e.g. LMS track rating value of 50 is displayed as 2.5 stars). You can enable or disable <b><i>setting</i> half-star ratings</b> on this page: <i>LMS settings</i> > <i>Advanced</i> > <i>Ratings Lights</i> > <i>Menus</i>.<br>If, for some reason, you have tracks with odd track rating values (e.g. 67), <i>Ratings Light</i> will round them to the nearest half-star rating - <i>for display</i> only, the actual rating values remain unchanged.</p></details><br>

<details><summary>»<b>Is <i>album</i> rating supported?</b>«</summary><br><p><i>“Album ratings“</i> as such do not exist in LMS, only <b>track</b> ratings. You can <b>set</b> a rating for all or only the unrated tracks in an album using the <b>album context menu</b>. Setting ratings for single album tracks in this menu is possible with the Default, Dark Default and Classic web skin.<br><br>RL does <b>not display</b> “album ratings“, i.e. the average track rating of all album tracks. Most albums would probably have a very low average track rating (displayed as zero stars) and you'd have to display the “album rating“ in the album context menu.<br>If you want albums sorted by (average) rating, take a look at the <a href="https://github.com/AF-1/lms-contextstats"><b>Context Stats</b></a> plugin.</p></details><br>
<details><summary>»<b>Is <i>album</i> rating supported?</b>«</summary><br><p><i>“Album ratings“</i> as such do not exist in LMS, only <b>track</b> ratings. You can <b>set</b> a rating for all or only the unrated tracks in an album using the <b>album context menu</b>. Setting ratings for single album tracks in this menu is possible with the Default, Dark Default and Classic web skin.<br><br>RL does <b>not display</b> “album ratings“, i.e. the average track rating of all album tracks. Most albums would probably have a very low average track rating (displayed as zero stars) and you'd have to display the “album rating“ in the album context menu.<br>If you want albums sorted by (average) rating, take a look at the <a href="https://github.com/AF-1/#-context-stats"><b>Context Stats</b></a> plugin.</p></details><br>

<details><summary>»<b>Does <i>Ratings Light</i> work with <i>online</i> tracks?</b>«</summary><br><p>It should work with online tracks that have been <b>added to your LMS library as part of an album</b>. LMS does not import single online tracks or tracks of online playlists as library tracks and therefore they cannot be processed by Ratings Light. That's a restriction imposed by LMS.</p></details><br>

Expand All @@ -114,7 +114,7 @@ More information, instructions, and fonts <a href="https://github.com/AF-1/sobra

<details><summary>»<b>Where does Ratings Light store track ratings?</b>«</summary><br><p><i>Ratings Light</i> does not use its own database. It tells LMS to store the track ratings in the <b>LMS</b> <i>persistent</i> database which is not cleared on rescans. However, if you value your ratings very much, I'd recommend to enable <i>scheduled</i> backups in RL. Or at least create occasional <i>manual</i> backups.</p></details><br>

<details><summary>»<b>Does <i>Ratings Light</i> auto-rate tracks when I play or skip them?</b>«</summary><br><p>No. Please use the <a href="https://github.com/AF-1/lms-alternativeplaycount#faq"><b>Alternative Play Count</b></a> plugin for that. It can auto-rate tracks and offers you an alternative, the <b>dynamic played/skipped value</b> that reflects your <b>recent</b> listening habits/decisions but does not mess with your tracking ratings.</p></details><br>
<details><summary>»<b>Does <i>Ratings Light</i> auto-rate tracks when I play or skip them?</b>«</summary><br><p>No. Please use the <a href="https://github.com/AF-1/#-alternative-play-count"><b>Alternative Play Count</b></a> plugin for that. It can auto-rate tracks and offers you an alternative, the <b>dynamic played/skipped value</b> that reflects your <b>recent</b> listening habits/decisions but does not mess with your tracking ratings.</p></details><br>

<details><summary>»<b>How do I migrate ratings from <i>TrackStat</i> to <i>Ratings Light</i>?</b>«</summary><br><p>You don't have to. Since ratings are stored in an LMS database (see FAQ above), you just <b>un</b>install <i>TrackStat</i> and install <i>Ratings Light</i>. TrackStat had its own database table (with identical columns though) but <i>ratings</i> should be in sync. You can even import ratings for <i>local</i> tracks from old TrackStat backup files.</p></details><br>

Expand Down

0 comments on commit f24829c

Please sign in to comment.