- Version: 2.2.2 (1/1/2025)
- License: GNU GPL 3
A Web Audio API library used in my Simple Voice Changer (soon to be renamed to Simple Sound Studio) and Memes Soundbox projects.
This library is written in TypeScript.
You can directly use the bundled version of the library that is present here: dist/esm/SimpleSoundStudioLibrary.js.
Or you can install the npm package using this command:
npm install @eliastik/simple-sound-studio-lib --save
The TypeScript types are directly provided by the package.
You also need to expose the worklet and worker files provided by the library at the root of your web application:
If you do not expose the files, the library will try to function as best as it can, but some features will fail:
- If worker files are not correctly exposed: the export-to-audio-file feature will not work, the VoiceRecorder feature won't work either
- If worklet files are not correctly exposed: the library will fallback to ScriptProcessorNode for certain filters. This implementation offers lower performance and quality but remains acceptable as a fallback
The documentation of the methods and class can be found here: docs/.
Documentation on the audio filters offered by the library can be found here: FILTERS.md.
The most important part is the AudioEditor class.
You will also be interested by the VoiceRecorder class.
To construct the object needed to use the features (AudioEditor class/VoiceRecorder class) you will need to use the SoundStudioFactory.
The project has the following directory structure:
dist/: Contains the compiled library files.example/: Contains the minimal example to use the library.docs/: Documentation for the library's classes and methods.lib/: Source code of the library written in TypeScript.tests/: Tests of the library using Jest
A minimal example using the library can be found here: example/index.html and example/index.js.
To use the example, you can pull the project and launch a webserver at the root folder of this git repository.
Here are a few ways to do this:
npm install --global http-server
http-server .
python -m http.server
php -S localhost:3000
Once the server is running, open example/index.html in your browser to see the minimal example in action.
Please note that there are other more advanced examples:
- example/audio-player.js: explain how to use the audio player
- example/custom-filter.js: explain how to create a custom audio filter
If you made a change to the library, you will need to compile it to use your change.
First, install the dependencies using:
npm install
Then use this to build the library to the dist folder:
npm run build
You can also launch the tests using:
npm run test
Une bibliothèque logicielle pour la Web Audio API utilisée par mes projets Simple Voice Changer (qui sera bientôt renommé Simple Sound Studio) et Memes Soundbox.
Cette bibliothèque est écrite en TypeScript.
Vous pouvez directement utiliser la version empaquetée de la bibliothèque qui est présente ici : dist/esm/SimpleSoundStudioLibrary.js.
Ou vous pouvez installer le package npm en utilisant la commande suivante :
npm install @eliastik/simple-sound-studio-lib --save
Les types TypeScript sont fournis directement par le package.
Vous devez également exposer les fichiers worklet et worker fournis par la bibliothèque à la racine de votre application web :
Si vous n'exposez pas les fichiers, la bibliothèque essaiera de fonctionner au mieux, mais certaines fonctionnalités échoueront :
- Si les fichiers worker ne sont pas correctement exposés : la fonction d'export d'audio ne fonctionnera pas, la fonctionnalité d'enregistrement audio (VoiceRecorder) ne fonctionnera pas non plus.
- Si les fichiers des worklets ne sont pas correctement exposés : la bibliothèque se rabattra sur ScriptProcessorNode pour certains filtres. Cette implémentation offre des performances et une qualité moindres, mais reste acceptable en tant que solution de repli.
La documentation des méthodes et des classes se trouve ici : docs/.
La documentation des filtres audio proposés par la librairie est ici : FILTERS.md.
La partie la plus importante est la classe AudioEditor.
Vous serez également intéressé par la classe VoiceRecorder.
Pour construire l'objet nécessaire à l'utilisation des fonctionnalités (classe AudioEditor/classe VoiceRecorder), vous devrez utiliser la SoundStudioFactory.
Le projet a la structure de répertoires suivante :
- dist/ : Contient les fichiers de la bibliothèque compilés.
- example/ : Contient l'exemple minimal d'utilisation de la bibliothèque.
- docs/ : Documentation des classes et des méthodes de la bibliothèque.
- lib/ : Code source de la bibliothèque écrit en TypeScript.
- tests/ : Tests de la bibliothèque utilisant Jest.
Un exemple minimal utilisant la bibliothèque se trouve ici : example/index.html et example/index.js.
Pour utiliser l'exemple, vous pouvez cloner le projet et lancer un serveur web à la racine de ce dépôt git.
Voici quelques façons de le faire :
npm install --global http-server
http-server .
python -m http.server
php -S localhost:3000
Une fois le serveur lancé, ouvrez example/index.html dans votre navigateur pour voir l'exemple minimal en action.
Il y a également d'autres exemples avancés :
- example/audio-player.js : montre comment utiliser le lecteur audio
- example/custom-filter.js : montre comment créer un filtre audio personnalisé
Si vous avez apporté une modification à la bibliothèque, vous devrez la compiler pour utiliser votre changement.
Commencez par installer les dépendances avec :
npm install
Ensuite, utilisez cette commande pour construire la bibliothèque dans le dossier dist :
npm run build
Vous pouvez également lancer les tests avec :
npm run test