deemix-gui/README.md

49 lines
2.2 KiB
Markdown
Raw Normal View History

2021-05-29 18:32:29 +02:00
# deemix-gui
An electron app that wraps deemix-webui and lets you use the deemix-js library
## Downloads
Downloads are available [here](https://www.reddit.com/r/deemix/comments/hmrhhs/download_links/)
## Running from source
You need to use nodejs 16.x, using `yarn` is recommended.
If you're using git to get this repo you should use `git submodule update --init --recursive` as well. If you're just downloading the archive.zip, make sure you download and extract deemix-webui into the webui folder.
2022-11-22 21:58:52 +01:00
Install the dependencies using `yarn install-all` for production.
Install the dependencies using `yarn install-all-dev` for development.
2021-05-29 18:32:29 +02:00
Then you should be able to run the app with `yarn start`.
2022-11-22 21:59:34 +01:00
If you want to further develop deemix-gui and propose a PR, use `yarn dev`
2022-11-22 21:58:52 +01:00
2022-11-22 21:59:34 +01:00
Commands for easy setup:
2022-11-22 21:58:52 +01:00
```sh
# Production
git clone https://gitlab.com/RemixDev/deemix-gui.git . && git submodule update --init --recursive && yarn install-all
# Development
git clone https://gitlab.com/RemixDev/deemix-gui.git . && git submodule update --init --recursive && yarn install-all-dev
```
2021-05-29 18:32:29 +02:00
2021-05-29 18:35:40 +02:00
You can change the default port by setting the environment variable `PORT` to any other number before starting the app.
2021-05-29 18:32:29 +02:00
## Building the app
To build the app you need to have git installed and the repo cloned with `git`.
2022-11-22 21:58:52 +01:00
Make sure you've installed the dependencies for all packages (the root folder, `server` and `webui`).
Then from the root folder run `yarn dist` to make a distributable package for your current OS or `yarn dist-server` to make an executable for only the server.
2021-05-29 18:32:29 +02:00
## Feature requests
Before asking for a feature make sure it isn't an already open issue on the repo
# License
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
2022-11-22 21:58:52 +01:00
along with this program. If not, see <https://www.gnu.org/licenses/>.