seewav

SeeWav: Animation Generator for Audio Waveforms

Overview

SeeWav is an innovative tool designed to bring audio waveforms to life through animated visualizations. It transforms audio files into engaging mp4 animations, making it an excellent choice for anyone looking to add a visual aspect to their audio content. A demonstration video is available to show the capabilities of SeeWav, accessible by clicking on the demo image.

Installation

To start using SeeWav, you'll need a few prerequisites:

• Python 3.7: Ensure you have this version of Python installed on your machine.

• FFmpeg: This software is necessary for encoding the animations. On Mac OS X, you can install it using Homebrew with the command brew install ffmpeg. If you're using Ubuntu, the required command is sudo apt-get install ffmpeg. Users of Anaconda can install it via conda install -c conda-forge ffmpeg.

Once these prerequisites are in place, you can install SeeWav with a simple command:

pip3 install seewav

How to Use SeeWav

Using SeeWav to generate animations is straightforward. The basic command format is:

seewav AUDIO_FILE [OUTPUT_FILE]

By default, the output file is named out.mp4, but you can specify a different output file name if desired. Additionally, there are various options available to customize the animation:

• -r, --rate: Set the video framerate.
• --stereo: Create animations with two waveforms for stereo audio files.
• -c, --color: Choose the color of the waveform bars using RGB values between 0 and 1.
• -c2, --color2: Set the color for the second waveform for stereo audio.
• --white: Use a white background instead of the default black.
• -B, --bars: Define the number of waveform bars in the animation at once.
• -O, --oversample: Adjust for reactivity; lower values yield smoother transitions.
• -T, --time: Specify the amount of audio to display on each frame.
• -S, --speed: Control transition speed between frames; higher values indicate quicker transitions.
• -W, --width and -H, --height: Set the dimensions of the animation in pixels.
• -s, --seek: Jump to a specific time in the audio file for starting the animation.
• -d, --duration: Determine the duration from the seek time for the part of the audio to animate.

These options allow users to tailor the animation to their preferences, ensuring the output matches their vision.

SeeWav offers a great way to visualize your audio in a dynamic and customizable manner, making audio content more interactive and appealing.