forked from external-repos/noisedash
Update README.md
This commit is contained in:
67
README.md
67
README.md
@@ -1,29 +1,56 @@
|
|||||||
# noisedash
|
# 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
|
npm install
|
||||||
|
NODE_ENV=production npm run build
|
||||||
```
|
```
|
||||||
|
|
||||||
### Compiles and hot-reloads for development
|
* The build files will be put into a directory called `dist`
|
||||||
```
|
* Run the server and serve static files:
|
||||||
npm run serve
|
|
||||||
|
``` bash
|
||||||
|
npm run server-prod
|
||||||
```
|
```
|
||||||
|
|
||||||
### Runs the server
|
# Contributing
|
||||||
```
|
|
||||||
npm run server
|
|
||||||
```
|
|
||||||
|
|
||||||
### Compiles and minifies for production
|
See [CONTRIBUTING.md](https://github.com/KevinThomas0/noisedash/blob/main/README.md)
|
||||||
```
|
|
||||||
npm run build
|
|
||||||
```
|
|
||||||
|
|
||||||
### Lints and fixes files
|
|
||||||
```
|
|
||||||
npm run lint
|
|
||||||
```
|
|
||||||
|
|
||||||
### Customize configuration
|
|
||||||
See [Configuration Reference](https://cli.vuejs.org/config/).
|
|
||||||
|
|||||||
Reference in New Issue
Block a user