forked from external-repos/noisedash
Update README.md
This commit is contained in:
67
README.md
67
README.md
@@ -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)
|
||||
|
||||
Reference in New Issue
Block a user