Files

T

R3ap3r 3178b8f4f7 Aurora SpotiRip desktop and web app

- Spotify playlist, library, album and artist browsing with in-app playback
- Song, playlist and album downloads via spotdl with YouTube and Bandcamp fallbacks
- Electron desktop app (castLabs Widevine) with a permanent sidebar layout
- Linux and Windows packaging scripts

2026-09-25 23:20:57 -05:00

2.1 KiB

Raw Blame History

Building the Windows installer

1. Install the tools (once)

Open PowerShell and run:

winget install Git.Git OpenJS.NodeJS.LTS Python.Python.3.12

Close PowerShell, open a new one, then:

npm install -g pnpm

2. Get the code

cd $HOME
git clone <your repository URL> aurora-spotirip
cd aurora-spotirip

To update an existing copy later: git pull.

3. Create the castLabs signing account (once)

Spotify only plays inside apps signed by castLabs on Windows. The account is free.

py -3 -m venv venv
venv\Scripts\python.exe -m pip install castlabs-evs
venv\Scripts\python.exe -m castlabs_evs.account signup

Follow the prompts and confirm the e-mail they send. On later builds the script signs you in again automatically (castlabs_evs.account reauth).

4. Build

pnpm dist:win

The first build takes a while (it downloads Python packages, ffmpeg and castLabs Electron). The installer ends up in release\Aurora SpotiRip Setup <version>.exe.

5. Install and set up

Run the installer. Windows shows "Windows protected your PC" because the installer is not code-signed: click More info → Run anyway.

Create %APPDATA%\Aurora SpotiRip\env.json with the Spotify keys:

{
  "SPOTIFY_CLIENT_ID": "...",
  "SPOTIFY_CLIENT_SECRET": "...",
  "AUDD_API_TOKEN": ""
}

In the Spotify Developer Dashboard, add the Windows user's Spotify account under User Management. In-app playback needs Spotify Premium.
Start Aurora SpotiRip and click Connect Spotify.

The redirect URI http://127.0.0.1:43117/spotify/callback is the same on every computer, so nothing else changes in the dashboard.

Troubleshooting

Songs play on another device instead of the PC: the castLabs signing step did not run; rebuild after venv\Scripts\python.exe -m castlabs_evs.account reauth.
Antivirus removes spotify_downloader.exe: some antivirus programs flag PyInstaller programs by mistake. Restore it and add an exception for the Aurora SpotiRip install folder.

2.1 KiB Raw Blame History