Skip to content

NotSpaulding/Soggfy

 
 

Repository files navigation

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, Soggfy can be injected into a running Spotify process by running Injector.exe.

Credits

About

Spotify ogg dumper

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 45.5%
  • TypeScript 45.4%
  • CSS 5.5%
  • PowerShell 2.6%
  • Other 1.0%