Scribbletune

Create music with JavaScript

Audio
scribbletune/scribbletunescribbletune.com/scribbletune

README

## SCRIBBLETUNE
Build Status Try scribbletune on RunKit

Use simple JavaScript Strings and Arrays to generate rhythms and musical patterns. Directly use the names of scales or chords in your code to get arrays which you can mash up using Array methods in ways you hadn't imagined before! Create clips of musical ideas and export MIDI files which you can import in _Ableton Live, Reason, GarageBand_ or any music creation software that accepts MIDI files.

Install


  1. ``` sh
  2. npm install scribbletune
  3. ```

Use it to create a MIDI clip by running a JS file from your terminal using node.js

  1. ``` js
  2. const scribble = require('scribbletune');
  3. const clip = scribble.clip({
  4.     notes: scribble.scale('C4 major'),
  5.     pattern: 'x'.repeat(7) + '_'
  6. });

  8. scribble.midi(clip, 'c-major.mid');
  9. ```

You can use Scribbletune even in the browser with Tone.js!. There are a couple of ways to do this. A quick and dirty way is to make sure to pull in Tone.js followed by the latest browser version of Scribbletune.

  1. ``` html
  2. <script src="https://cdnjs.cloudflare.com/ajax/libs/tone/<LATEST-VERSION-FROM-CDNJS>/Tone.min.js"</script>
  3. <script src="https://cdnjs.cloudflare.com/ajax/libs/scribbletune/<LATEST-VERSION-FROM-CDNJS>/scribbletune.js"</script>
  4. ```

This will expose a global object called scribble which you can directly use to run the methods from Scribbletune in conjunction with Tone.js

The recommended way for the browser, however, is to import it like this
  1. ``` js
  2. const scribble = require('scribbletune/browser');
  3. ```
This will provide the same API but augment it a bit to support browser based functionality.

Similarly, you can use the Scribbletune API for Max for Live development by doing
  1. ``` js
  2. const scribble = require('scribbletune/max');
  3. ```
Just like the browser version this too will enable the same API but with some added bells and whistles for Max for Live.

Visit scribbletune.com for documentation, tutorials and examples! Listen to music generated with Scribbletune on Soundcloud.