mirror of
https://github.com/kaythomas0/noisedash.git
synced 2025-11-20 06:58:03 +00:00
57 lines
1.4 KiB
Markdown
57 lines
1.4 KiB
Markdown
# Noisedash
|
|
|
|
Self-hostable web tool for generating ambient noises.
|
|
|
|
# Features
|
|
|
|
* Generate and customize ambient noises and user-uploadable samples
|
|
* Save "noise profiles" so you can easily switch between your created soundscapes
|
|
* Fine-tune your noises with audio processing tools like filters, LFOs, and effects
|
|
* Upload audio samples (e.g rain, wind, thunder) to combine with your generated noises
|
|
* Manage multiple users
|
|
|
|
# Installation
|
|
|
|
## Docker
|
|
|
|
Requires docker and docker-compose
|
|
|
|
* Download the provided [docker-compose.yml file](https://github.com/KevinThomas0/noisedash/blob/main/docker-compose.yml)
|
|
* In the same directory as the docker-compose file, created a folder called `config`, and inside it, put the provided [config file](https://github.com/KevinThomas0/noisedash/blob/main/config/default.json)
|
|
* Edit the config file to your preference
|
|
* Bring the container up:
|
|
|
|
``` bash
|
|
docker-compose up -d
|
|
```
|
|
|
|
## From Source
|
|
|
|
Requires node 14 and npm
|
|
|
|
* Clone the repo:
|
|
|
|
``` bash
|
|
git clone https://github.com/KevinThomas0/noisedash.git
|
|
cd noisedash
|
|
```
|
|
|
|
* Edit `config/default.json` to your preference
|
|
* Install required packages and build the app:
|
|
|
|
``` bash
|
|
npm install
|
|
NODE_ENV=production npm run build
|
|
```
|
|
|
|
* The build files will be put into a directory called `dist`
|
|
* Run the server and serve static files:
|
|
|
|
``` bash
|
|
npm run server-prod
|
|
```
|
|
|
|
# Contributing
|
|
|
|
See [CONTRIBUTING.md](https://github.com/KevinThomas0/noisedash/blob/main/README.md)
|