Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/surikov/midi-sounds-react
ReactJS component for musical and MIDI applications
https://github.com/surikov/midi-sounds-react
Last synced: 25 days ago
JSON representation
ReactJS component for musical and MIDI applications
- Host: GitHub
- URL: https://github.com/surikov/midi-sounds-react
- Owner: surikov
- License: mit
- Created: 2018-01-12T13:29:05.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-04-23T17:14:54.000Z (over 6 years ago)
- Last Synced: 2024-07-19T10:47:51.744Z (5 months ago)
- Language: JavaScript
- Homepage:
- Size: 1.61 MB
- Stars: 127
- Watchers: 9
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-javascript-audio - midi-sounds-react - nice examples of using soundfonts, includes a simple music sequencer (MIDI instruments / Multi-instruments)
README
# Component for [React](https://reactjs.org/).
You can use 1500 digitized musical instruments and percussions from free sound library to build musical application with React framework.
## Examples
- [how to preload and play an instrument](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example1/build)
- [how to preload and play a drum](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example2/build)
- [how to create selectable list of instruments and delay for loading](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example3/build)
- [how to create selectable list of drum](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example4/build)
- [how to play short musical fragments](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example5/build)
- [how to create sequencer](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example6/build)
- [how to use strumming](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example7/build)
- [how to use strumming for guitar music](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example8/build)
- [how to programmatically change properties of sound](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example9/build)
- [how to attach sounds to piano keys](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example10/build)
- [how to use independed channels](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example11/build)
[Sources of all examples](https://github.com/surikov/midi-sounds-react-examples/tree/master/examples)
## Tutorial
Open Node.js command line window.
Create React application from [https://reactjs.org/tutorial/tutorial.html](https://reactjs.org/tutorial/tutorial.html)
Modify package.json to add dependency to **midi-sounds-react** component
```
{
"name": "my-test",
"version": "0.1.0",
"private": true,
"homepage": "https://myserver",
"dependencies": {
"react": "^16.2.0",
"react-dom": "^16.2.0",
"react-scripts": "1.1.0",
"midi-sounds-react": "^1.2.45"
},
"scripts": {
"start": "react-scripts start",
"build": "react-scripts build",
"test": "react-scripts test --env=jsdom",
"eject": "react-scripts eject"
}
}
```
Install dependencies
```
npm install
```
Start application
```
npm start
```
Navigate browser to http://localhost:3000
Modify src/App.js to add an Component and button.
```js
import React, { Component } from 'react';
import logo from './logo.svg';
import './App.css';
import MIDISounds from 'midi-sounds-react';
class App extends Component {
playTestInstrument() {
this.midiSounds.playChordNow(3, [60], 2.5);
}
render() {
return (
Welcome to midi-sounds-react example 1
Press Play to play instrument sound.
Play
(this.midiSounds = ref)} appElementName="root" instruments={[3]} />
);
}
}
export default App;
```
### Main parts
```js
import MIDISounds from 'midi-sounds-react';
```
- import **midi-sounds-react** component
```html
(this.midiSounds = ref)}
appElementName="root" instruments={[3]}
/>
```
- insert component into page
```js
this.midiSounds.playChordNow(3, [60], 2.5);
```
- play sound
See [live example](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example1/build), download example from [https://github.com/surikov/midi-sounds-react-examples](https://github.com/surikov/midi-sounds-react-examples).
## Reference
### Component parameters
```html
(this.midiSounds = ref)}
appElementName="root"
instruments={[111]}
drums={[2,33]}
/>
```
- this.midiSounds - variable to use component from code
- appElementName - name of main div of application
- instruments - array of instruments to preload
- drums - array of drums to preload
### Initializing
MIDISounds will be initialized after first render. Use componentDidMount to rerender page with initialized component.
```js
componentDidMount() {
console.log('rerender after init');
this.setState(this.state);
}
```
[Live example](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example4/build)
### Play continuous note sounds
Use this.midiSounds.player.queueWaveTable to start sound and return reference to envelope.
Use envelope.cancel() to stop sound.
[Live example](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example10/build)
### List of drums
Use this.midiSounds.player.loader.drumsKeys() to get array of drums.
Use this.midiSounds.player.loader.drumInfo(i).title to get readable drum name.
[Live example](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example4/build)
### List of instruments
Use this.midiSounds.player.loader.instrumentKeys() to get array of drums.
Use this.midiSounds.player.loader.instrumentInfo(i).title to get readable drum name.
[Live example](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example3/build)
### Load instrument
Use this.midiSounds.cacheInstrument and this.midiSounds.cacheDrum to start instrument and drum loading.
Use this.midiSounds.player.loader.waitLoad to wait till all instruments and drums are loaded.
[Live example](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example3/build)
### Change instrument and drum volume
Use setInstrumentVolume(instrument, volume) and setDrumVolume(drum, volume)
[Live example](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example9/build)
### Change Master Volume
Use setMasterVolume(n).
[Live example](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example9/build)
### Change Echo Level
Use setEchoLevel(value).
[Live example](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example9/build)
### Change Equalizer
- setBand32(level)
- setBand64(level)
- setBand128(level)
- setBand256(level)
- setBand512(level)
- setBand1k(level)
- setBand2k(level)
- setBand4k(level)
- setBand8k(level)
- setBand16k(level)
[Live example](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example9/build)
### Cancel all sounds
Use cancelQueue()
### Time
Use contextTime() to get current time of Audio context.
How to calculate musical durations
```
var bpm = 120;
var N = 4 * 60 / bpm;
var duration16th = N/16;
```
### Play drums
- playDrumsAt(when, drums)
- playDrumsNow(drums)
parameters
- when - time
- drums - array of drum numbers
### Play instruments
- playChordNow(instrument, pitches, duration)
- playChordAt(when, instrument, pitches, duration)
- playStrumUpNow(instrument, pitches, duration)
- playStrumUpAt(when, instrument, pitches, duration)
- playStrumDownAt(when, instrument, pitches, duration)
- playStrumDownNow(instrument, pitches, duration)
- playSnapNow(instrument, pitches, duration)
- playSnapAt(when, instrument, pitches, duration)
parameters
- when - time
- instrument - number of instrument
- pitches - array of pitches
- duration - durations
### Play beat
```
playBeatAt(when, beat, bpm)
```
- when - time
- beat - array of drums and chords
- bpm - beats per minute
Example of beat array
```
[
[
drum1
,drum2
]
,[
[guitar,[S6+1,S5+3,S4+3],1/4,down]
[bass,[S6+1,S5+3,S4+3],1/4]
]
]
```
- drum1, drum2 - numbers of drums
- guitar, bass - numbers of instruments
- [S6+1,S5+3,S4+3] and [S6+1,S5+3,S4+3] - array with pitches
- 1/4 - duration as part of full note for the bpm
- down - 1|2|3 for strum down, strum up or snap
### Play loop
```
startPlayLoop(beats, bpm, density, fromBeat)
```
- beats - array of beat arrays
- bpm - beats per minute
- dencity - duration of row at array
- fromBeat - start beat number
Use stopPlayLoop() to cancel play.
[Live example](https://surikov.github.io/midi-sounds-react-examples/examples/midi-sounds-example9/build)
## How to get help
Feel free to ask any help at project [issues](https://github.com/surikov/midi-sounds-react/issues).