This repository containes the current Web Audio API standard document, developed by the Audio Working Group at the W3C. There are multiple implementations of the Web Audio API standard.
If you're about to open an issue about a bug in a particular implementation, please file a ticket in the corresponding implementation bug tracker instead:
- WebKit (Safari): https://bugs.webkit.org/enter_bug.cgi?product=WebKit&component=Web%20Audio (WebKit bugzilla account needed).
- Blink (Chrome, Chromium, Electron apps, etc.): https://new.crbug.com/ (Google account needed).
- Gecko (Firefox): https://bugzilla.mozilla.org/enter_bug.cgi?product=Core&component=Web%20Audio (GitHub or Mozilla Bugzilla account needed).
Testing the same Web Audio API code in multiple implementations can be a quick way to check if an implementation has a bug. However, it has happened that different implementation have the same bug, so it's best to read the standard document, and to check what should happen.
Feature requests are welcome, but a quick search in the opened and closed issues is welcome to avoid duplicates.
Pull requests are also welcome, but any change to the standard (barring things like typos and the like) will have to be discussed in an issue (and possibly during a call, accessible only to W3C Audio Working Group members).
Bikeshed is the tool used to write this specification. It can either be used via an HTTP API, or by running it locally.
To use it via the HTTP API, run:
curl https://api.csswg.org/bikeshed/ -F [email protected] -F force=1 -F output=err -o err && cat err | sed -E 's/\\033\[([0-9]{1,2}(;[0-9]{1,2})?)?[m|K]//g' | diff -u - expected-errs.txt
and preview your changes by doing:
curl https://api.csswg.org/bikeshed/ -F [email protected] -F force=1 > index.html
and opening index.html
in your favorite browser.
To run it locally, follow the installation instructions.
Then, bikeshed serve
will run a web server locally on port
8000.