Installation

npm Package

Install MIDI Sketch Bach as a dependency in your Node.js project:

npm install @libraz/midi-sketch-bach

yarn add @libraz/midi-sketch-bach

pnpm add @libraz/midi-sketch-bach

Then import and use it in your code:

import { init, BachGenerator } from '@libraz/midi-sketch-bach'

await init()
const generator = new BachGenerator()

CLI (Global Install)

Install globally to use the @libraz/midi-sketch-bach command anywhere:

npm install -g @libraz/midi-sketch-bach

Or run directly without installing:

npx @libraz/midi-sketch-bach --form fugue -o fugue.mid

Browser Usage

MIDI Sketch Bach runs in the browser via WebAssembly. When using in a browser environment, specify the path to the WASM file:

import { init, BachGenerator } from '@libraz/midi-sketch-bach'

// Specify the WASM file location for browser environments
await init({ wasmPath: '/wasm/midisketch.wasm' })

const generator = new BachGenerator()
generator.generate({ form: 'invention', key: 0 })

const midi = generator.getMidi()
// Create a download link
const blob = new Blob([midi], { type: 'audio/midi' })
const url = URL.createObjectURL(blob)

WASM Path

In Node.js, the WASM file is resolved automatically. In browser environments, you need to provide the wasmPath option pointing to where the .wasm file is served.

Bundler Configuration

Vite

For Vite projects, ensure the WASM file is served correctly:

// vite.config.js
export default {
  optimizeDeps: {
    exclude: ['@libraz/midi-sketch-bach']
  }
}

Webpack

For Webpack, you may need to configure asset handling for .wasm files:

// webpack.config.js
module.exports = {
  experiments: {
    asyncWebAssembly: true
  }
}

System Requirements

• Node.js: 18.0 or later
• Browser: Any modern browser with WebAssembly support (Chrome, Firefox, Safari, Edge)
• No native dependencies: The package is pure JavaScript + WebAssembly