Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jberg/butterchurn
Butterchurn is a WebGL implementation of the Milkdrop Visualizer
https://github.com/jberg/butterchurn
assemblyscript music-visualizer reimplementation visualization wasm webaudio-api webgl webgl2
Last synced: 1 day ago
JSON representation
Butterchurn is a WebGL implementation of the Milkdrop Visualizer
- Host: GitHub
- URL: https://github.com/jberg/butterchurn
- Owner: jberg
- License: mit
- Created: 2018-04-22T05:35:19.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-03-18T10:55:12.000Z (9 months ago)
- Last Synced: 2024-04-26T22:42:18.917Z (8 months ago)
- Topics: assemblyscript, music-visualizer, reimplementation, visualization, wasm, webaudio-api, webgl, webgl2
- Language: JavaScript
- Homepage: https://butterchurnviz.com/
- Size: 5.46 MB
- Stars: 1,491
- Watchers: 24
- Forks: 119
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-repos - jberg/butterchurn - Butterchurn is a WebGL implementation of the Milkdrop Visualizer (JavaScript)
README
# Butterchurn
Butterchurn is a WebGL implementation of the Milkdrop Visualizer
## [Try it out](https://butterchurnviz.com)
[](https://butterchurnviz.com)
## Usage
### Installation
With [yarn](https://yarnpkg.com/) or [npm](https://npmjs.org/) installed, run
$ yarn add butterchurn butterchurn-presets
or
$ npm install butterchurn butterchurn-presets
### Create a visualizer
```JavaScript
import butterchurn from 'butterchurn';
import butterchurnPresets from 'butterchurn-presets';
// initialize audioContext and get canvas
const visualizer = butterchurn.createVisualizer(audioContext, canvas, {
width: 800,
height: 600
});
// get audioNode from audio source or microphone
visualizer.connectAudio(audioNode);
// load a preset
const presets = butterchurnPresets.getPresets();
const preset = presets['Flexi, martin + geiss - dedicated to the sherwin maxawow'];
visualizer.loadPreset(preset, 0.0); // 2nd argument is the number of seconds to blend presets
// resize visualizer
visualizer.setRendererSize(1600, 1200);
// render a frame
visualizer.render();
```
### Browser Support
Butterchurn requires the [browser support WebGL 2](https://caniuse.com/#feat=webgl2).
You can test for support using our minimal isSupported script:
```Javacript
import isButterchurnSupported from "butterchurn/lib/isSupported.min";
if (isButterchurnSupported()) {
// Load and use butterchurn
}
```
## Integrations
* [Webamp](https://github.com/captbaritone/webamp), the fantastic reimplementation of Winamp 2.9 in HTML5 and Javascript, built by [captbaritone](https://github.com/captbaritone)
* [Butterchurn Extension](https://chrome.google.com/webstore/detail/butterchurn-music-visuali/jfdmelgfepjcmlljpdeajbiiibkehnih), use Butterchurn to visualize the audio from any page
* [Rekt Networks](https://nightride.fm/#Mathdrop), Live DJs, Archives & Exclusive Releases, built by [Zei](https://twitter.com/TheRektNetwork)
* [mStream](http://mstream.io/), your personal music streaming server, built by [IrosTheBeggar](https://github.com/IrosTheBeggar)
* [pasteur](https://www.pasteur.cc/), trippy videos generated from your music, built by [markneub](https://github.com/markneub)
* [ChromeAudioVisualizerExtension](https://chrome.google.com/webstore/detail/audiovisualizer/bojhikphaecldnbdekplmadjkflgbkfh), put on some music and turn your browsing session into a party! built by [afreakk](https://github.com/afreakk)
* [Karaoke Forever](https://www.karaoke-forever.com), an open karaoke party system, built by [bhj](https://github.com/bhj)
* [Syqel](https://syqel.com/), the World's Best AI Powered Music Visualizer
## Thanks
* [Ryan Geiss](http://www.geisswerks.com/) for creating [MilkDrop](http://www.geisswerks.com/about_milkdrop.html)
* Nullsoft for creating [Winamp](http://www.winamp.com/)
* All the amazing preset creators, special thanks to [Flexi](https://twitter.com/Flexi23)
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details