https://github.com/hathibelagal-dev/musicviz
A really simple music visualizer
https://github.com/hathibelagal-dev/musicviz
Last synced: 4 months ago
JSON representation
A really simple music visualizer
- Host: GitHub
- URL: https://github.com/hathibelagal-dev/musicviz
- Owner: hathibelagal-dev
- License: apache-2.0
- Created: 2025-05-16T08:42:41.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-05-16T10:30:33.000Z (6 months ago)
- Last Synced: 2025-06-12T16:14:15.211Z (5 months ago)
- Language: Python
- Size: 15.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MusicViz
MusicViz is a Python tool that generates a dynamic music visualizer video from an audio file (MP3 or WAV). It creates a video with animated frequency spectrum bars synchronized to the audio, using a colorful plasma colormap and a black background for a vibrant visual experience. The output is an MP4 video file with the audio embedded.
## Features
- Generates a visualizer with non-overlapping frequency bars based on the audio's spectrogram.
- Supports MP3 and WAV audio inputs.
- Customizable video title displayed in the output.
- Produces high-quality 1920x1080 MP4 videos at 30 FPS.
- Uses a plasma colormap for visually appealing, frequency-based coloring.
## Installation
First create a new conda environment:
```
conda create -n musicv python=3.11
```
Then activate it:
```
conda activate musicv
```
You can now install musicviz:
```
pip3 install musicviz
```
## Dependencies
### Install FFmpeg:
This tool requires FFmpeg for video encoding.
Download and install FFmpeg from ffmpeg.org or via a package manager:
On Ubuntu:
```
sudo apt-get install ffmpeg
```
On macOS:
```
brew install ffmpeg
```
Ensure ffmpeg is available in your system PATH.
## Usage
Run the `musicviz` tool from the command line, providing the input audio file, output video file, and a title for the video.
```
musicviz
```
For example:
```
musicviz song.mp3 output.mp4 "My Awesome Track"
```
## Output
The output is a 1920x1080 MP4 video with:
- Frequency bars that pulse with the audio's amplitude.
- A black background with a plasma colormap for bars.
- The specified title displayed at the top.
- The original audio embedded in the video.