thanksPei / Bizualizer

A visualizer addon for blender

Bizualizer

Contents

• Bizualizer
  • Tutorial Video
  • Installation
  • Usage
  • Examples
  • Batch Bizualizer
    • Installation (Windows)
    • Installation (Linux)
    • Usage
    • CSV Options

Tutorial Video

Installation

1. Download the repository
2. Open Blender
3. Got to File > User Preferences > Addons
4. click "Install From File" and navigate to the downloaded .zip folder
5. Check the box next to "bizualizer"
6. Save User Settings

Use the correct release for your Blender version. Add-ons for Blender 2.80 and above will not work for Blender 2.79

Usage

In the properties window, click the scene button. The UI is at the bottom. Add a song by clicking the button with a folder icon. You can adjust the settings and generate the visualizer. Some examples are shown below.

Examples

Batch Bizualizer

This part of the addon will allow you to use a .csv file with visualizer settings for several songs to create the visualizer for the entire batch. Unfortunately, this part of the addon requires you to install some extras...

Installation (Windows)

Install ffmpeg by downloading the executable, then add the path to that executable to your system variable Path. If done correctly, you should be able to enter ffmpeg into your command prompt without getting an error.

Install pip.exe into your Blender python folder by downloading get-pip.py and running it with the python.exe located in your Blender installation folder. You'll need to use a command prompt with admin priveledges.

Use pip.exe in the Scripts folder to install mutagen and pillow. Do path/to/pip.exe install mutagen pillow. Again, you'll need to use an admin level command prompt to do this.

Installation (Linux)

Install ffmpeg with sudo apt-get install ffmpeg

Install pillow and mutagen using pip. To get pip download get-pip.py and run it with: sudo python get-pip.py Then install the two packages like this:

sudo pip install pillow mutagen

Usage

• Create a .csv file like the one included in this package.
• Place all mp3 files and png files into the same folder where the .csv file is located
• Open blender and use the 'Config File' browse button to navigate to the .csv file
• Open the Blender Terminal so you can see the Addon Working
  • (Windows) Window -> Toggle System Console
  • (Linux) Start Blender with the terminal
• Run Batch Bizualize

CSV Options

Song:	(Required) The name of the song, for example: We Belong.mp3
Background:	(Required) The name of the background image, for example: birds.png
Bar Color:	(hexcode) The color that will be applied to the visualize bars.
Bar Count:	(integer) The number of bars that will be displayed in the visualizer
Bar Style:	The visualizer style. Options include: bottom, top, top-bottom, left, right, left-right, horizontal-center, vertical-center
Space Fraction:	(Float from 0.0 to 1.0) Controls the spacing between bars.
Height Fraction:	(Float from 0.0 to 1.0) Controls the amplitude of the bars.
Fade:	(0 or 1) Add Fade in & out to the video
Opacity:	(Float from 0.0 to 1.0) Controls the opacity of the visualizer bars.