Update README.md

This commit is contained in:
Kevin Thomas
2021-11-11 22:29:32 -08:00
parent abc5c6a0ab
commit 351d36601c

View File

@@ -1,29 +1,56 @@
# noisedash
## Project setup
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
```
### Compiles and hot-reloads for development
```
npm run serve
* The build files will be put into a directory called `dist`
* Run the server and serve static files:
``` bash
npm run server-prod
```
### Runs the server
```
npm run server
```
# Contributing
### Compiles and minifies for production
```
npm run build
```
### Lints and fixes files
```
npm run lint
```
### Customize configuration
See [Configuration Reference](https://cli.vuejs.org/config/).
See [CONTRIBUTING.md](https://github.com/KevinThomas0/noisedash/blob/main/README.md)