Skip to content

Elip100/SpotMod

Repository files navigation

SpotMod - A simple mod injector for Spotify

SpotMod is a simple tool that allows you to inject JavaScript and CSS into Spotify.

SpotMod is very early in development, and many features are planned for the future.

Features

🟩 - Implemented
🟨 - Experimental
🟥 - Planned for the future

Feature Status Notes
Windows support 🟩 Binaries can be found here
Mac/Linux support 🟥 May not be added for a while...
Inject JS into CEF 🟩
Inject CSS into CEF 🟨 Styles may be overridden
Modify existing JS 🟥
Modify image files and other resources 🟥

Usage

To use the tool, download the latest version here and run it (Windows only). Spotify must have been downloaded from the Spotify website (not the Microsoft Store). If you installed Spotify from the Microsoft Store, uninstall it and click "Download directly from Spotify" on this page.

Updating

To update SpotMod, download the new injector EXE file and run it. As soon as you open the new injector, you will be prompted to update the loader. Choose yes and it will automatically update while keeping all of your mods. Some versions require different steps when updating, so make sure to check the release description for details.

Building

To build the injector from source, clone the repo. As of version 0.5, SpotMod uses uv to manage and install Python dependencies — uv must be installed on your system before proceeding. If uv is not installed, install it using your preferred method (for example, pip install uv or your system package manager).

From the root directory of the project, sync the requirements with:

uv sync

After dependencies are installed, build the injector with:

pyinstaller "SpotMod Injector.spec"

You will find the executable in the dist folder.

About

A simple mod injector for Spotify

Resources

License

Security policy

Stars

Watchers

Forks

Contributors 2

  •  
  •