/spicetify-css-map-analyzer

Analyzes Spicetify's css-map.json and prints mapped, unmapped classes for current Spotify version

Primary LanguageJavaScriptMIT LicenseMIT

📦 Archiving this repo due to time constraints. Feel free to fork and continue the development! 🍴

Spicetify css-map Analyzer

Analyzes Spicetify's css-map.json and prints mapped, unmapped classes for current Spotify version


Getting Started (installation) :

  • Clone this repository git clone https://github.com/Tetrax-10/spicetify-css-map-analyzer
  • Make sure NodeJS is installed
  • Run npm install to install dependencies
  • Make sure you have latest Spotify installed
  • Also make sure you installed latest commit version of Spicetify
  • Done !
How to analyze older Spotify versions

If you want to analyze older versions of Spotify, then install the appropriate version of Spicetify for the version of Spotify you want to analyze. To know the appropriate Spicetify version just skim through the Spicetify releases section.

Eg : To analyze Spotify 1.2.7.1277.g2b3ce637 you should install Spicetify v2.16.2

analyze 1.2.7

How to install older Spiceify versions?

  • Just clone spicetify-cli repo by git clone https://github.com/spicetify/spicetify-cli
  • Choose the version you wanna install with VScode branches
  • then run go build -o spicetify.exe to build Spicetify
  • then cd to spicetify-css-map-analyzer and run npm run analyze-css-map

install older spicetify versions


Usage :

To analyze and print all classes in css-map.json for currently installed Spotify and Spicetify versions

npm run analyze-css-map

To analyze and print unmapped classes in css-map.json for currently installed Spotify and Spicetify versions

npm run analyze-unmapped-css

To analyze and print mapped classes in css-map.json for currently installed Spotify and Spicetify versions

npm run analyze-mapped-css

To analyze and print mappable hash classes present in current theme for currently installed Spotify and Spicetify versions. Also prints unfound hash classes and deprecated classes used in the current theme.

npm run analyze-theme

Run help command to see available options

npm run analyzer -- --help

Run custom combination commands like this npm run analyzer -- [args]

npm run analyzer -- --unmapped --theme --sort --out

Outputs :

Analyzed report

Lists the mapped/unmapped/all classes according to the command you ran. Also tells how much percent of css-map.json got mapped for currently installed Spotify and Spicetify version.

analyzed result


Generated output files

These output files contains mapped/unmapped/all classes.

output files

These files are useful for comparing what got unmapped when comparing them with other versions of Spotify.

Eg: Comparing Spotify 1.2.10.760.g52970952 and 1.2.11.914.gd3175972

compare output files


Theme analyzer

Lists mappable hash classes present in current theme

compare output files