Protonosgit / Spicetify_Installer

Install, manage and update spicetify from an easy to use gui written in python
GNU Lesser General Public License v2.1
9 stars 4 forks source link
easy-to-use gui installer modding music patches pyqt5 pyqt6 python spicetify spotify

spicetify manager icon

Spicetify Manager

A project for installing and managing Spicetify from a Gui written in python and running on PyQt6. The manager comes included with tools like block Spotify updates and a mode for running automatically on boot/Spotify startup.

GitHub release (with filter) GitHub commit activity (branch) GitHub last commit (by committer) GitHub (Pre-)Release Date GitHub code size in bytes GitHub repo file count (file type)

Attention:

This repo is looking for a new maintainer! I personally don't have the time anymore to support this project in the future, so feel free to reach out if you're interested ❤️

Screenshot

Key Features

Made with Love by Protonos

Installation and Running

If you do not trust the generated binary you may run the application directly with your local python installation using the provide instructions below.

  # Download the project
  git clone https://github.com/Protonosgit/Spicetify_Installer.git

  # Install required dependencies
  pip install -r requirements.txt

  #Start the application
  python main.py

Important!

Only the main.py file will start the application!
The other files are dynamically used as components and windows.

Building binary

  # Download the project
  git clone https://github.com/Protonosgit/Spicetify_Installer.git

  # Install required dependencies
  python -m pip install requirements.txt
  python -m pip install pyinstaller

  # Build using pyinstaller and predefined config
  pyinstaller main.spec

  # Alternatively build an optimized version using upx (slower)
  pyinstaller main.spec --upx-dir "./upx"

Usage Guide

[1] After running the main.py file wait a few seconds for the menu to show up

[2] Click on install and wait for the process to finish

[3] Inside the spotify window search for the shopping cart in the sidebar on the left

[4] Click on the icon and download your favorite themes, addons and more...

Uninstalling

Simply click on the uninstall icon in the bottom right and confirm your choice

Updating, Activating, Repairing

All of the above will be automatically detected, just confirm the actions!

Manager API

Due to rate limiting I decided to create my own relay for the official Github api. It just returns the latest release tag from the spicetify-cli repo.
You can monitor the status here: Netlify Status
There might be more efficient ways to do this so feel free to suggest any improvements as an issue!

Safety

This project was flagged by some antivirus programs and I currently don't know how to avoid this! So feel free to download the executables from Github actions and use them instead of the release files (They are identical)

Currently Windows only! If would like to improve support for other Platforms feel free to do so!

Acknowledgements