Skip to content

Latest commit

 

History

History
51 lines (37 loc) · 3.54 KB

README.md

File metadata and controls

51 lines (37 loc) · 3.54 KB
Raw

Soggfy - SpotifyOggDumper

A music downloader mod for the Windows Spotify client

Features

  • Download tracks directly from Spotify
  • Download and embed metadata, lyrics and canvas
  • Generate M3U for albums and playlists
  • Automatic conversion to MP3 and many other formats

Installation and Usage

  1. Download and extract the .zip package of the latest release.
  2. Double click the Install.cmd file. It will run the Install.ps1 script with Execution Policy Bypass. Wait for it to finish.
  3. Open Spotify and play the songs you want to download.

Tracks are saved in the Music folder by default. The settings panel can be accessed by hovering next to the download button in the navigation bar.
Hovering the check mark drawn on each individual track will display a popup offering to open the folder containing them.

You may need to disable or whitelist Soggfy in your anti-virus for it to work.

If the Spotify client crashes because of missing DLLs, you may need to install the MSVC Redistributable package.

Notes

  • Songs are only downloaded if played from start to finish, without seeking (pausing is fine).
  • Quality depends on the account being used: 160Kb/s or 320Kb/s for free and premium plans respectively. You may also need to change the streaming quality to "Very high" on Spotify settings to get 320Kb/s files.
  • Podcast support is very hit or miss and will only work with audio-only OGG podcasts (usually the exclusive ones).
  • This mod breaks Spotify's Guidelines and using it could get your account banned. Consider using alt accounts or keeping backups (see Exportify and SpotMyBackup).

How it works

Soggfy works by intercepting Spotify's OGG parser and capturing the unencrypted data during playback. This process is similar to recording, but it results in an exact copy of the original files served by Spotify, without ever extracting keys or actually re-downloading them.
Conversion and metadata is then applied according to user settings.

Manual Installation

If you are having issues with the install script, try following the steps below for a manual installation:

  1. Download and install the correct Spotify client version using the link inside the Install.ps1 script.
  2. Copy and rename SpotifyOggDumper.dll to %appdata%/Spotify/dpapi.dll
  3. Copy SoggfyUIC.js to %appdata%/Spotify/SoggfyUIC.js
  4. Download and extract FFmpeg binaries to %localappdata%/Soggfy/ffmpeg/ffmpeg.exe (or add them to %PATH%).

Alternatively, Injector.exe can be used to launch or inject Soggfy into an already running Spotify instance. A portable and self-contained install can be made by copying Spotify binaries from %appdata%/Spotify/ to Soggfy/Spotify/.

Credits