timidity
Play MIDI files in the browser w/ Web Audio, WebAssembly, and libtimidity
Play MIDI files in a browser with a simple API.
Demo
This package is used on BitMidi.com, the wayback machine for old-school MIDI files! Check out some examples here:
- Backstreet Boys - I Want It That Way MIDI
- Beethoven Moonlight Sonata MIDI
- Kingdom Hearts - Dearly Beloved MIDI
- Camptown Races MIDI
- Michael Jackson - Billie Jean MIDI
- Michael Jackson - Don't Stop Till You Get Enough MIDI
- Passenger - Let Her Go MIDI
- Red Hot Chili Peppers - Otherside MIDI
- Red Hot Chili Peppers - Californication MIDI
- Golden Sun - Overworld MIDI
- Pokemon - Pokemon Center Theme MIDI
- Pokemon Red Blue Yellow - Opening MIDI
- Pokemon Red Blue Yellow - Wild Pokemon Battle MIDI
- Legend of Zelda - Overworld MIDI
Install
npm install timidity
Features
- Lightweight β Just 23 KB of JavaScript and 22 KB of lazy-loaded WebAssembly
- Simple β No bells and whistles. Just what is needed to play MIDI files.
- Works with the FreePats General MIDI soundset.
Usage
const Timidity = require('timidity')
const player = new Timidity()
player.load('/my-file.mid')
player.play()
player.on('playing', () => {
console.log(player.duration) // => 351.521
})
Easier Usage
If you just want to play MIDI files in the browser and don't need a JavaScript
API interface, consider using the
bg-sound
package, which supports
this much simpler usage:
<script src="bg-sound.min.js"></script>
<bg-sound src="sound.mid"></bg-sound>
API
player = new Timidity([baseUrl])
Create a new MIDI player.
Optionally, provide a baseUrl
to customize where the player will look for the
lazy-loaded WebAssembly file libtimidity.wasm
and the
FreePats General MIDI soundset files.
The default baseUrl
is /
.
For example, here is how to mount the necessary files at /
with the express
server:
const timidityPath = path.dirname(require.resolve('timidity'))
app.use(express.static(timidityPath))
const freepatsPath = path.dirname(require.resolve('freepats'))
app.use(express.static(freepatsPath))
player.load(urlOrBuf)
This function loads the specified MIDI file urlOrBuf
, which is a string
path
to the MIDI file or a Uint8Array
which contains the MIDI file data.
This should be the first function called on a new Timidity
instance.
player.play()
Plays the currently loaded MIDI file.
player.pause()
Pauses the currently loaded MIDI file.
player.seek(seconds)
Seeks to a specified time in the MIDI file.
If the player is paused when the function is called, it will remain paused. If the function is called from another state (playing, etc.), the player will continue playing.
player.duration
Returns the duration in seconds (number
) of the currently playing MIDI file.
Note that duration
will return 0
until the file is loaded, which normally
happens just before the playing
event.
player.currentTime
Returns the elapsed time in seconds since the MIDI file started playing.
player.destroy()
Destroys the entire player instance, stops the current MIDI file from playing, cleans up all resources.
Note: It's best to reuse the same player instance for as long as possible. It is
not recommended to call player.destroy()
to stop or change MIDI files. Rather,
just call player.pause()
to pause or player.load()
to load a new MIDI file.
player.destroyed
Returns true
if destroy()
has been called on the player. Returns false
otherwise.
player.on('error', (err) => {})
This event fires if a fatal error occurs in the player, including if a MIDI file is unable to be played.
player.on('timeupdate', (seconds) => {})
This event fires when the time indicated by the currentTime
property has been
updated.
player.on('unstarted', () => {})
This event fires when a new MIDI file is being loaded.
player.on('ended', () => {})
This event fires when a MIDI file has played until the end.
player.on('playing', () => {})
This event fires when a MIDI file starts playing.
player.on('paused', () => {})
This event fires when a MIDI file is paused.
player.on('buffering', () => {})
This event fires when a MIDI file is loading.
License
Copyright (c) Feross Aboukhadijeh.