Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nfroidure/midifile
A MIDI file parser/writer using ArrayBuffers
https://github.com/nfroidure/midifile
hacktoberfest midi
Last synced: 1 day ago
JSON representation
A MIDI file parser/writer using ArrayBuffers
- Host: GitHub
- URL: https://github.com/nfroidure/midifile
- Owner: nfroidure
- License: mit
- Created: 2013-07-04T20:12:52.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2018-04-29T10:49:26.000Z (over 6 years ago)
- Last Synced: 2024-12-15T15:39:23.858Z (10 days ago)
- Topics: hacktoberfest, midi
- Language: JavaScript
- Homepage: http://karaoke.insertafter.com
- Size: 334 KB
- Stars: 199
- Watchers: 16
- Forks: 30
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[//]: # ( )
[//]: # (This file is automatically generated by a `metapak`)
[//]: # (module. Do not change it except between the)
[//]: # (`content:start/end` flags, your changes would)
[//]: # (be overridden.)
[//]: # ( )
# midifile
> Read/write standard MIDI files.
[](https://npmjs.org/package/midifile)
[](https://travis-ci.org/nfroidure/midifile)
[](https://david-dm.org/nfroidure/midifile)
[](https://david-dm.org/nfroidure/midifile#info=devDependencies)
[](https://coveralls.io/r/nfroidure/midifile?branch=master)
[](https://codeclimate.com/github/nfroidure/midifile)
[](https://dependencyci.com/github/nfroidure/midifile)
[//]: # (::contents:start)
MIDIFile uses the [MIDIEvents](https://github.com/nfroidure/midievents) project
and is part of the [MIDIPlayer](https://github.com/nfroidure/midiplayer) one.
You can also check this [Karaoke Player](http://karaoke.insertafter.com) built
on top of those libraries.
## What it does
* Read MIDI files
* Check MIDI file structure (using strictMode)
* Write MIDI files (still experimental)
## What it doesn't do
* Playing MIDI files. It's the role of the
[MIDIPlayer project](https://github.com/nfroidure/midiplayer).
## Usage
```js
// Your variable with your MIDI file as an ArrayBuffer or UInt8Array instance
var anyBuffer;
// Creating the MIDIFile instance
var midiFile = new MIDIFile(anyBuffer);
// Reading headers
midiFile.header.getFormat(); // 0, 1 or 2
midiFile.header.getTracksCount(); // n
// Time division
if(midiFile.header.getTimeDivision() === MIDIFile.Header.TICKS_PER_BEAT) {
midiFile.header.getTicksPerBeat();
} else {
midiFile.header.getSMPTEFrames();
midiFile.header.getTicksPerFrame();
}
// MIDI events retriever
var events = midiFile.getMidiEvents();
events[0].subtype; // type of [MIDI event](https://github.com/nfroidure/MIDIFile/blob/master/src/MIDIFile.js#L34)
events[0].playTime; // time in ms at wich the event must be played
events[0].param1; // first parameter
events[0].param2; // second one
// Lyrics retriever
var lyrics = midiFile.getLyrics();
if ( lyrics.length ) {
lyrics[0].playTime; // Time at wich the text must be displayed
lyrics[0].text; // The text content to be displayed
}
// Reading whole track events and filtering them yourself
var events = midiFile.getTrackEvents(0);
events.forEach(console.log.bind(console));
// Or for a single track
var trackEventsChunk = midiFile.tracks[0].getTrackContent();
var events = MIDIEvents.createParser(trackEventsChunk);
var event;
while(event = events.next()) {
// Printing meta events containing text only
if(event.type === MIDIEvents.EVENT_META && event.text) {
console.log('Text meta: '+event.text);
}
}
```
## Testing
Unit tests are using mocha and NodeJS. Install them and run the following command:
```bash
mocha tests/*.mocha.js
```
## Why ArrayBuffers ?
ArrayBuffer instances are the best way to manage binary data like MIDI files.
## Why not streams ?
The Standard MIDI files format isn't streamable by nature. If you want to stream
MIDI file contents, you should consider transforming your files in another
format (plain linearized MIDI events should do the job).
## Requirements
* ArrayBuffer, DataView or their polyfills
## Contributing
* Feel free to PR
* If you find a MIDI File the library can't read an if it's under a free, PR
the file in the sounds folder and add tests for him. I'll work on it asap.
[//]: # (::contents:end)
# License
[MIT](https://github.com/nfroidure/midifile/blob/master/LICENSE)