Visualizes live audio using gifs.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Visualization of live audio using gifs. This is based on Scott W Harden's "Realtime FFT Audio Visualization with Python".

Prepare gif

You can use dough, watermelon or add a new gif like this:

Use ImageMagick: convert -coalesce image.gif image.jpg

Create a directory in the frames subdirectory and copy the image frames into it.

If you found a cool gif, please send me a message/pull request. Thanks!


  • pygame
  • scipy
  • numpy
  • pyaudio


apt-get install python-pygame python-scipy python-numpy python-pyaudio


Play some audio and run Press F11 to toggle full-screen mode. Use Escape to exit.

Visualization moves but no audio playing?

I had to use pavucontrol (PulseAudio Volume Control apt-get install pavucontrol) to select "Analog Stereo Output" instead of "Analog Stereo Duplex" (Configuration tab). If you want to use an external input device (like a microphone) use "Analog Stereo Input".


I uploaded some demos to YouTube.


Read the corresponding blog post for further details.