static

brew install adithyasource/tools/static

a local copy of your spotify, statically stored

effortlessly and accurately syncs up all your spotify playlists into a folder on your computer so that you can have an offline copy at all times. i made this so that i can sync that folder up my phone using syncthing and have free access to all my spotify songs on the foobar2000 app, neatly separated by playlist folders.

currently only tested on macOS

⚠️ for personal use

instructions

installation

install it using brew

brew install adithyasource/tools/static

or you can use it manually

• clone the repository with git clone https://github.com/adithyasource/static/
• setup the project using uv with uv sync
• run the program using uv run main.py

spotify setup

these instructions are also prompted during the spotify account connection process where you'll be entering the obtained client id and secret

• create a spotify developers account at developer.spotify.com
• go to the dashboard and create an app
• make sure to add the redirect uri as http://localhost:9321
• obtain the client id and secret

contributing

first of all, thank you so much for using the script and deciding to contribute! i really appreciate it ^-^
please try to do the following before opening a pull request!

• lint and format the code using ruff (i use ty for type check and lsp)
• keep code clean and minimal while only adding dependencies when absolutely necessary
• make sure that if a feature is added, it is kept inline with the projects aesthetic and goals

feedback

if there are any features or bug fixes you'd like to suggest, please open a new issue!

acknowledgments

tech	python

notable libs	questionary	yt_dlp

apis	spotify