This is a programmable music visualizer written in Rust. You can write a script to map audio input to visual output for your viewing pleasure.
It uses a number of external crates, notably Piston for graphical output.
You'll need cargo. To get going quickly: cargo run [audio file] [script].
Writing a script is easy. You can find an example script in the /examples folder.
The first thing you'll need to do is specify a background. This can be done as below (at the top of the script file):
bg: background{Argument = Expr, ...}
Individual graphical effects are written as follows:
effect{Argument = Expr, ...}
You can then map the inputs to the effect to Expressions. Expressions support simple arithmetic using Audio Components and constant values. You can have as many effects as you like. You can also write the arguments for the effects in any order, but they need to be named - they also have default values, so you don't have to specify them all.
Expressions can include special built-in functions. They are used as follows:
func(arg, ...)
Functions have the highest precedence. The cond function is quite special: it takes 3 arguments. It checks if the first argument is > 0: if it is, the second argument is returned. Else, the third argument is returned. Note also that unlike effects, argument names do NOT have to be specified.
Something else you can do is edit in real time. Write a script and save it while running the visualiser and it will update automatically. Note this may not work with all text editors: it works with mousepad but not with vim!
MP3 & WAV
- fill{R, G, B}
- circles{Size, Width, R[ed], G[reen], B[lue], Trans[parency], X, Y}
- dots{Size, R, G, B, Trans, Count, X, Y}
- bar{Size, Width, R, G, B, Trans, X, Y}
- Impulse (Level above a threshold)
- Level (Average level)
- Effects.
- Audio outputs.
- Constants.
- Expressions: +,-,*,/ and ()
- Functions: sin, cos, floor, ceil, cond
- Actually playing music - with controls.
- Frequency components from audio.
- Normalise audio data, and sync more with graphics.
- Add more backgrounds.
- Add better ways of dealing with colour (HSV).
- Add decay/delay controls to primitives.
- Adding bindings for variables and functions in the script.
- Adding more in-built functions.
- More graphic effects!
- Window doesn't scale properly.
- Some instability when script refreshes.
- Script parser is not very verbose.
- Inconsistencies in co-ords of effects.
- Backgrounds require a bit of clean up.
- No good tests!