How spotx-official/spotx works
SpotX is a Windows Spotify desktop patcher, with companion client-side helpers for filtering home-feed content and reporting listening history. The main user workflow is documented as selecting an installer or PowerShell parameters, then modifying the installed Spotify client; implementation details for that installer and most patch capabilities were not sampled, so those links are documented rather than inferred. The sampled helpers show fetch interception, section filtering, version-reporting logic, and track reporting. The README supplies the broader patch capabilities; unsampled installer internals are represented only at their supported paths.
Main entry points: run.ps1 PowerShell entry · checkVersion.js Version checker · goofyHistory.js Track reporter · Install_New_theme.bat New-theme install
Components 19
Installation and removal
- New-theme install
Install_New_theme.bat - Old-theme install
Install_Old_theme.bat - Full installer
scripts/Install_Auto.bat - Premium installer
scripts/Install_Prem.bat - PowerShell entry
run.ps1 - Uninstaller
Uninstall.bat
Client modifications
- Client patches
patches - Patch catalog
patches/patches.json - Lyrics colors
css-helper/lyrics-color/colors.css - Lyrics rules
css-helper/lyrics-color/rules.css
Client helpers
- Home-feed filter
js-helper/sectionBlock.js - Track reporter
js-helper/goofyHistory.js
Version reporting
- Version checker
js-helper/checkVersion.js
Other components
- Windows user
- Spotify desktop
- Spotify update API
- Version ingest service
- Google Form
- Browser local storage
Connections 25
- Windows user → New-theme install: runs
README.md - Windows user → Old-theme install: runs
README.md - Windows user → Full installer: runs
README.md - Windows user → Premium installer: runs
README.md - Windows user → PowerShell entry: invokes
README.md - Windows user → Uninstaller: runs
README.md - New-theme install → PowerShell entry: invokes
- Old-theme install → PowerShell entry: invokes
- Full installer → PowerShell entry: invokes
- Premium installer → PowerShell entry: invokes
- PowerShell entry → Spotify desktop: patches
README.md - Uninstaller → Spotify desktop: removes modifications
- Client patches → Spotify desktop: modifies
README.md - Patch catalog → Client patches: defines patches
- Lyrics colors → Spotify desktop: styles lyrics
- Lyrics rules → Spotify desktop: styles lyrics
- Spotify desktop → Home-feed filter: fetches feed
js-helper/sectionBlock.js - Home-feed filter → Spotify desktop: returns filtered feed
js-helper/sectionBlock.js - Spotify desktop → Track reporter: emits track event
- Track reporter → Browser local storage: reads and writes
js-helper/goofyHistory.js - Track reporter → Google Form: posts track URI
js-helper/goofyHistory.js - Spotify desktop → Version checker: provides update context
- Version checker → Spotify update API: requests update assets
js-helper/checkVersion.js - Version checker → Version ingest service: reports results
js-helper/checkVersion.js - Version checker → Browser local storage: stores success report