BeepBox is a music synthesizer, along with an online editor for authoring songs that you can try out at beepbox.co!

The editor stores all song data in the URL as text after the hash mark, and this song data can be easily copied and shared. You can use the code in this npm package to synthesize music out loud from this song data, just like in the editor!

BeepBox is a passion project, and will always be free to use. If you find it valuable and have the means, any gratuity via PayPal would be appreciated! BeepBox is developed by John Nesky, and this code is available under the MIT license.

You can easily use a script tag to load the synthesizer code, then use the global beepbox namespace to access the synthesizer:

<script src="https://cdn.jsdelivr.net/npm/beepbox/global/beepbox_synth.min.js"></script>
<script>
	const {Synth} = beepbox;
</script>

Or you could do it with the fancy module syntax:

<script type="module">
    import {Synth} from "https://cdn.jsdelivr.net/npm/beepbox/esm/synth/index.js";
</script>

If you're using npm, you can use that to install the synthesizer on the command line:

npm install beepbox

And then in your code you can import the synthesizer as a module:

import {Synth} from "beepbox";

Deploying code to your website that was written in this manner is a complex subject that's outside the scope of this README, but the advantage is that you can use many advanced tools, including TypeScript.

Regardless of how you load the synthesizer code, you can use the Synth class in your code to play and pause songs. Copy the song data from BeepBox's online editor URL then pass that to the Synth contructor:

var synth = new Synth("#9n30sbk7l00e00t2-a7g00j00r1i0o443T0v2u00f0qw02d03w2h0E0T0v2u00f0qw02d03w2h0E0T0v0u00f0qw02d03w1h0E0bUp1OFEYtghQ4sBihS7dQQuwE8W2eywzwPbGcKCzZk4t17hghQCngpo");

document.getElementById("playButton").addEventListener("click", event => {
	if (synth.playing) {
		synth.pause();
	} else {
		synth.play();
	}
});

Make sure that the playback is triggered by a user input event, such as a "click" event.

The npm package called beepbox has changed. If you were using npm to access the beepbox package before 2024-09, that version of the package has moved to beepbox-lite. Please update your dependencies!