databender

Databender

NOTE: This API may change wildly in v2... use at your own peril!

This module allows for generation interesting visuals by misusing the Web Audio API. Inspired by David Byrne and AudioShop

Full API documentation and such is coming soon.

Getting Started

The quickest way to get something on the page:

• Run npm i in your project and make sure you have an image to point to somewhere.
• Paste the following snippet into index.html and point the image to the location of the image you'd like to bend.

<img
  crossorigin="anonymous"
  style="display:none"
  src="http://picsum.photos/800"
/>
<canvas height="1280" width="1280"></canvas>

<script src="node_modules/databender/dist/databender.js"></script>
<script>
  const loadDatabender = () => {
    const img = document.querySelector("img");
    const canvas = document.querySelector("canvas");
    const context = canvas.getContext("2d");
    const config = {
      bitcrusher: {
        active: true,
        bits: 4,
        normfreq: 0.004,
        bufferSize: 2048
      },
      biquad: {
        active: true,
        detune: 20,
        randomize: true,
        quality: 2.1,
        randomValues: 10,
        type: "highpass",
        biquadFrequency: 200
      },
      detune: {
        active: true,
        value: 0.0
      }
    };
    const databender = new Databender(config);
    databender.bend(img, context);
  };

  window.onload = () => {
    document.addEventListener("click", () => {
      loadDatabender();
    });
  };
</script>

• Start up a server (e.g. python -m SimpleHTTPServer)
• Behold!

You might also prefer using this in a CommonJS manner:

const Databender = require("databender");

Since I am lazy, you'll need to deduce what config you want for each effect that is included by looking in the effects directory. At some point, this may be removed from the app, and it will be up to you to include whatever effects and dependencies you would like to use with your bent data.

Prerequisites

Google Chrome (ideally) and an open mind!

Built With

• TunaJS - A splendid audio effects library.
• Rollup - Module bundling

Contributing

Creating a CONTRIBUTING.md is on the list of things to do. Feel free to submit issues/PRs.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Examples

Drawdio
Jonathan Taylor Tuner
Granular Synth
Conway's Game of Databending