imported>WeekBot: Added spin ratings section: 1-5 star system with chart score multipliers

2026-04-12T05:25:54Z

Added spin ratings section: 1-5 star system with chart score multipliers

New page

{{SHORTDESC:Monthly vinyl singles charts by King Warz}}
[[File:King_warz_logo_black.png|thumb|right|150px|King Warz logo as of January 2025.]]

The '''Vinyl Singles Charts''' are monthly personal charts tracking the vinyl singles listening habits of [[King Warz]]. Data is collected by manually searching and selecting records from his physical vinyl collection through the app's web dashboard, and the charts are automatically generated by a custom-built program called '''KWC Vinyl Charts''', developed with the assistance of [[Claude (AI)|Claude]], an AI assistant by Anthropic.

The first chart, covering spins logged during '''March 1 – March 31, 2026''', was generated and published on '''April 11, 2026'''.

== Background ==

=== From streaming to vinyl ===
King Warz had been running personal streaming charts since November 2024, with data retroactively generated back to February 2020, powered by a program called ''Levboard'' which pulled data from his Spotify account via Stats.fm (see ''[[King Warz Charts]]''). In early 2026, as his physical vinyl collection grew, Warz wanted a way to track and chart his vinyl spins with the same level of detail he had for streaming.

=== Spun It and its limitations ===
Warz initially used an app called '''Spun It''' to log his vinyl plays. While the app provided basic spin tracking, it did not offer everything he needed — features like chart generation, detailed statistics, and integration with his existing chart ecosystem were either missing or locked behind a paywall. Rather than continue paying for an incomplete solution, Warz decided to build his own system from scratch.

=== Building KWC Vinyl Charts ===
With the help of '''Claude''', an AI coding assistant, Warz developed '''KWC Vinyl Charts''' — a fully custom application that replicates and expands on what Spun It offered. The program runs locally on his home server and handles both album and singles charts from a single system. For a full description of the application's capabilities, see [[Vinyl Album Charts#Building KWC Vinyl Charts|Vinyl Album Charts: Building KWC Vinyl Charts]].

Historical spin data from Spun It was imported into the system. These imported spins are preserved in the database for reference but are '''excluded from chart calculations''' to ensure only natively-tracked data influences chart positions.

== How the singles charts work ==

=== Data collection ===
Singles are logged the same way as albums — by searching for and selecting the record through the web dashboard. Each spin records the timestamp, duration, full or partial play status, and the specific pressing (variant) in the collection. For full details on data collection, see [[Vinyl Album Charts#Data collection|Vinyl Album Charts: Data collection]].

=== Chart period ===
Like the [[Vinyl Album Charts]], the Vinyl Singles Charts operate on '''monthly''' periods:
* Each chart covers a full calendar month (1st to last day)
* Charts are numbered sequentially, sharing the same month number as the corresponding album chart (e.g., both Album Month 1 and Singles Month 1 cover March 2026)
* If a month does not meet the minimum threshold, no chart is generated

=== Eligibility ===
For a singles chart to be generated, at least '''3 unique singles''' must have been spun during the chart period. Only spins with <code>source</code> other than <code>import</code> count toward eligibility.

The chart displays up to '''5 singles''', ranked by chart score.

=== Chart score ===
The singles chart uses the same no-ties scoring formula as the album chart:

<pre>
chart_score = (adjusted_spins x 1000)
+ (previous_chart_points x 50)
+ (duration_minutes / 100)
+ (consecutive_months x 2)
+ (lifetime_adjusted_spins x 0.001)
+ (total_duration_seconds / 1,000,000)
</pre>

For a detailed explanation of each factor, see [[Vinyl Album Charts#Chart score (no-ties formula)|Vinyl Album Charts: Chart score]].

=== Spin ratings and their chart impact ===
Each spin can optionally be rated on a '''1 to 5 star''' scale, with an optional '''comment''' about the listening experience. Ratings apply a multiplier to the spin's adjusted value, directly influencing the chart score:

{| class="wikitable" style="margin:auto; text-align:center"
! Rating !! Multiplier !! Effect
|-
| Unrated || 1.0x || Neutral
|-
| 1 star || 0.6x || Strong penalty
|-
| 2 stars || 0.8x || Moderate penalty
|-
| 3 stars || 1.0x || Neutral
|-
| 4 stars || 1.15x || Moderate reward
|-
| 5 stars || 1.3x || Strong reward
|}

For a full explanation of how ratings work, see [[Vinyl Album Charts#Spin ratings and their chart impact|Vinyl Album Charts: Spin ratings]].

=== Points and units ===
* '''Points''' are awarded based on chart position: <code>(chart_size + 1) − position</code>. On a 3-entry chart, #1 earns 3 points, #2 earns 2, #3 earns 1.
* '''Units''' represent an all-time performance score: <code>Units = (2 x lifetime_adjusted_spins) + total_chart_points</code>

=== Movement codes ===
The '''MV''' column shows how a single's position changed from the previous month:
* '''NEW''' — first-ever appearance on the chart
* '''RE''' — re-entry after being absent from the previous month's chart
* '''=''' — no change in position
* '''▲N''' — moved up by N positions
* '''▼N''' — moved down by N positions

=== Chart columns ===
{| class="wikitable"
! Column !! Meaning
|-
| '''MV''' || Movement from previous month
|-
| '''Single''' || Single title and artist(s)
|-
| '''TW''' || This Week (current position)
|-
| '''LW''' || Last Week (previous month's position, or "-" if new)
|-
| '''MO''' || Months on Chart (total appearances)
|-
| '''SPN''' || Raw spin count during the period
|-
| '''PTS''' || Points earned this month
|-
| '''PK''' || Peak position (best-ever rank)
|}

=== Publishing ===
The publishing process is identical to the album charts. When a chart is published:
* A cover art collage is generated from the top 3 singles' artwork (displayed as a horizontal strip)
* The collage is uploaded to the wiki
* The chart page is created with the full article, infobox, statistics, and categories
* The chart is locked in the database

For full details on the publishing workflow, see [[Vinyl Album Charts#Publishing|Vinyl Album Charts: Publishing]].

== Differences from the Album Charts ==

{| class="wikitable"
! Feature !! Album Charts !! Singles Charts
|-
| Minimum releases for chart || 5 unique albums || 3 unique singles
|-
| Maximum chart size || 10 || 5
|-
| Collage layout || 2×2 grid (top 4) || 1×3 horizontal strip (top 3)
|-
| ADJ column || Included || Not included
|}

== See Also ==
* [[Vinyl Album Charts]]
* [[King Warz Charts]]

[[Category:Vinyl Singles Charts]]
[[Category:King Warz Charts]]

Vinyl Singles Charts - Revision history

imported>WeekBot: Added spin ratings section: 1-5 star system with chart score multipliers