Awesome Open Source
Awesome Open Source


Python script to record the audio of the Spotify desktop client using FFmpeg and PulseAudio



If you use the AUR package, you can simply run:


If you have a GNU/Linux distribution with a different package manager system, run:



First of all run spotify.

Then you can run the python script which will record the music:

./ -o ./my_song_dir --skip-intro

Check the pulseaudio configuration:


Pay attention to the red circles, everything else is muted and with volume set to 0%

playback tab

Note: actually "Lavf..." will appear after you start playing a song

recording tab

output devices tab

input devices tab

configuration tab

Finally start playing whatever you want


  • Disable volume normalization in the Spotify Client

  • Do not change the volume during recording

  • Use Audacity for post processing

    • because SpotRec records a little longer at the end to ensure that nothing is missing of the song. But sometimes this also includes the beginning of the next song. So you should use Audacity to cut the audio to what you want. From Audacity you can also export it to the format you like (ogg/mp3/...).


Start the script with the debug flag:

./ --debug

If one of the following scenarios happens:

  • you do not see something like the ffmpeg output, which should appear right few seconds after the song start
# what you should see when ffmpeg is recording ...
size=56400kB time=00:00:04.15 bitrate= 130.7kbits/s speed=1x
  • you do not see any "Lavf..." in the pavucontrol recording tab
  • you get a stacktrace ending with:
ValueError: invalid literal for int() with base 10: 'nput'

I would suggest you to:

  • quickly press the "next song button" and then the "previous song button" in the spotify client
  • stop everything and start over, after some tries it usually works :)

Note: sometimes spotify detects when the user does not interact with the application for a long time (more or less an hour) and starts looping over a song, to avoid this scenario I would suggest to keep interacting with the spotify client.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Python (1,123,905
Pulseaudio (146
Related Projects