https://github.com/scribbletune/scribbletune

Create music with JavaScript
https://github.com/scribbletune/scribbletune

ableton ableton-live chords javascript live midi music nodejs scale webaudio webaudioapi webmidi

Last synced: 15 days ago
JSON representation

Create music with JavaScript

• Host: GitHub
• URL: https://github.com/scribbletune/scribbletune
• Owner: scribbletune
• License: mit
• Created: 2013-11-25T21:44:43.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2024-06-18T06:24:12.000Z (5 months ago)
• Last Synced: 2024-08-04T00:06:51.878Z (3 months ago)
• Topics: ableton, ableton-live, chords, javascript, live, midi, music, nodejs, scale, webaudio, webaudioapi, webmidi
• Language: TypeScript
• Homepage: https://scribbletune.com/
• Size: 2.24 MB
• Stars: 3,699
• Watchers: 89
• Forks: 237
• Open Issues: 23
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
##  SCRIBBLETUNE

[![Build Status](https://travis-ci.com/scribbletune/scribbletune.svg?branch=master)](http://travis-ci.com/scribbletune/scribbletune)

[![Try scribbletune on RunKit](https://badge.runkitcdn.com/scribbletune.svg)](https://npm.runkit.com/scribbletune)

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

```bash

npm install scribbletune

```

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

```javascript

const scribble = require('scribbletune');

const clip = scribble.clip({

    notes: scribble.scale('C4 major'),

    pattern: 'x'.repeat(7) + '_'

});

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

```

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](https://cdnjs.com/libraries/tone) followed by the [latest browser version of Scribbletune](https://cdnjs.com/libraries/scribbletune).

```html

```

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

```javascript

const scribble = require('scribbletune/browser');

```

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

```javascript

const scribble = require('scribbletune/max');

```

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](https://scribbletune.com) for documentation, tutorials and examples! Listen to music generated with Scribbletune on [Soundcloud](https://soundcloud.com/scribbletune).