MusicScraper

Windows desktop downloader: load a Spotify playlist (or a text file of titles), search YouTube, and save an MP3 ZIP archive.

Installation

Distribute MusicScraper-Setup.exe: a standard Inno Setup wizard installer.

1. Download and run MusicScraper-Setup.exe
2. Follow the setup wizard
3. Launch MusicScraper from the Start menu

On first run the app creates:

%APPDATA%\MusicScraper\config.env

Default download folder (not removed on uninstall):

%USERPROFILE%\Music\MusicScraper

System requirements

• Windows 10/11
• FFmpeg
• Node.js 22+

Paths are auto-detected when possible; otherwise set them in config.env.

config.env

FFMPEG_PATH=
NODE_PATH=
DEFAULT_DESTINATION=
LIST_FILE=

If FFmpeg or Node is missing/invalid, the app shows an error and does not start.

Uninstall

Start menu → Uninstall MusicScraper, or Windows Settings → Apps.

This removes the program and %APPDATA%\MusicScraper.
It does not delete songs/ZIPs under Music\MusicScraper.

Usage

1. Load a public Spotify playlist URL, or a titles file
2. Choose the destination folder
3. Start download → downloaded_songs.zip

Development

python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt
python main.py

Build (exe + wizard)

1. Install Inno Setup 7 (free): https://jrsoftware.org/isdl.php
2. Run:

.\build.ps1 -Installer

File to distribute: release\MusicScraper-Setup.exe

App exe only (no wizard): .\build.ps1

Notes

• Private Spotify playlists are not supported.
• FFmpeg and Node are not bundled in the setup (kept as external, updatable dependencies).