LSD (Linux Spotify Downloader)

LSD (Linux Spotify Downloader) is a command line tool for downloading or rather recording content on Spotify.


  • Python 3.6 or higher
  • any Linux distribution with PulseAudio as its sound server
  • git, ffmpeg and pip

Installation and preparation

  1. Clone this git-repository:

    git clone
  2. install the dependencies (python libraries):

    pip3 install -r requirements.txt
  3. visit and create a new app, then copy the “Client ID” and “Client Secret” and add them into the configuration section of “


  1. Run LSD with “python3
  2. Enter the path to your output directory. (If you always want to export to the same folder, you can also enter the path in the configuration section of ““.)
  3. Open the Spotify Application and wait a few seconds until LSD has initialized the recording interface using PulseAudio
  4. Now you can play a playlist, audiobook, podcast or individual tracks. Everything is recorded and then separated and tagged fully automatically.
    LSD only records the audio output from Spotify, but you should still make sure that you don’t fast-forward tracks or record multiple times, otherwise the program won’t work properly when exporting.
  5. Close Spotify as soon as you are finished recording.


Fastr is under the terms of the Apapche 2.0 license, following all clarifications stated in the license file


View Github