# scratch-audio

> audio engine for scratch 3.0

Latest version **2.0.268** (published 2025-11-18) · AGPL-3.0-only license · 0 weekly downloads

## Install

```sh
npm install scratch-audio
pnpm add scratch-audio
yarn add scratch-audio
bun add scratch-audio
```

## Health

**Score 50/100 (C)** — status: stable.

Positive: no vulnerabilities; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 2.0.268 |
| Published | 2025-11-18 |
| First published | 2017-01-06 |
| Weekly downloads | 0 |
| License | AGPL-3.0-only |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 791.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 71 |
| Author | Massachusetts Institute of Technology |
| Maintainers | cwillisf.scratch |

## Links

- npm: https://www.npmjs.com/package/scratch-audio
- Repository: https://github.com/scratchfoundation/scratch-audio
- Homepage: https://github.com/scratchfoundation/scratch-audio#readme
- Issues: https://github.com/scratchfoundation/scratch-audio/issues
- npm.io page: https://npm.io/package/scratch-audio

## Dependencies (3)

- [minilog](https://npm.io/package/minilog.md) ^3.0.1
- [audio-context](https://npm.io/package/audio-context.md) ^1.0.1
- [startaudiocontext](https://npm.io/package/startaudiocontext.md) ^1.2.1

## Recent versions

- 2.0.268 (latest) — 2025-11-18
- 2.0.267 — 2025-11-16
- 2.0.266 — 2025-11-16
- 2.0.265 — 2025-11-15
- 2.0.264 — 2025-11-15
- 2.0.263 — 2025-11-14
- 2.0.262 — 2025-11-13
- 2.0.261 — 2025-11-12
- 2.0.260 — 2025-11-11
- 2.0.259 — 2025-11-11
- 2.0.258 — 2025-11-08
- 2.0.257 — 2025-11-07
- 2.0.256 — 2025-11-07
- 2.0.255 — 2025-11-04
- 2.0.254 — 2025-11-03
- … 642 more at https://npm.io/package/scratch-audio/versions

## README

# scratch-audio
#### Scratch audio engine is for playing sounds, instruments and audio effects in Scratch 3.0 projects

[![Greenkeeper badge](https://badges.greenkeeper.io/LLK/scratch-audio.svg)](https://greenkeeper.io/)

#### Please note this project is at an early stage and we are not ready for pull requests

[![CircleCI](https://circleci.com/gh/LLK/scratch-audio/tree/develop.svg?style=shield&circle-token=3792f4f51158c8c9b448527466ffe302b0c6f0f5)](https://circleci.com/gh/LLK/scratch-audio?branch=develop)

## Installation
This requires you to have Git and Node.js installed.

In your own node environment/application:
```bash
npm install https://github.com/scratchfoundation/scratch-audio.git
```
If you want to edit/play yourself:
```bash
git clone git@github.com:LLK/scratch-audio.git
cd scratch-audio
npm install
```

## Testing
```bash
npm test
```

## Donate
We provide [Scratch](https://scratch.mit.edu) free of charge, and want to keep it that way! Please consider making a [donation](https://secure.donationpay.org/scratchfoundation/) to support our continued engineering, design, community, and resource development efforts. Donations of any size are appreciated. Thank you!

## Committing

This project uses [semantic release](https://github.com/semantic-release/semantic-release) to ensure version bumps
follow semver so that projects depending on it don't break unexpectedly.

In order to automatically determine version updates, semantic release expects commit messages to follow the
[conventional-changelog](https://github.com/bcoe/conventional-changelog-standard/blob/master/convention.md)
specification.

You can use the [commitizen CLI](https://github.com/commitizen/cz-cli) to make commits formatted in this way:

```bash
npm install -g commitizen@latest cz-conventional-changelog@latest
```

Now you're ready to make commits using `git cz`.

---
_Source: https://npm.io/package/scratch-audio · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._