docs: added proper readme
This commit is contained in:
parent
3782f7b4fe
commit
6f9fd7170f
67
README.md
67
README.md
@ -1,6 +1,63 @@
|
|||||||
## todo
|
# Wake-On-Lan Dashboard
|
||||||
|
|
||||||
- separate data access into repositories
|

|
||||||
- (possibly switch database away from LowDB)
|
|
||||||
- make /sessions
|
## Features
|
||||||
- make user dropdown work with keyboard navigation
|
|
||||||
|
- Send [magic packets](https://en.wikipedia.org/wiki/Wake-on-LAN#Magic_packet) to any device on the network on which the panel is hosted to wake them up
|
||||||
|
- If necessary, customize broadcast IP, port and the amount of packets sent
|
||||||
|
- Users management and groups management with device access based on user permissions or on group permissions
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
Copy and rename `.env.example` to `.env` and customize it to your needs.
|
||||||
|
|
||||||
|
The different options are docummented directly in [`.env.example`](.env.example).
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>The easy way - building and running on the same machine</summary>
|
||||||
|
|
||||||
|
**Node version < 20.6** - Run:
|
||||||
|
|
||||||
|
- `npm run build`
|
||||||
|
- `npm i dotenv`
|
||||||
|
- `node -r dotenv/config build`
|
||||||
|
|
||||||
|
**Node version >= 20.6** - Run:
|
||||||
|
|
||||||
|
- `npm run build`
|
||||||
|
- `node --env-file=.env build`
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>The longer way - building and running on different machines</summary>
|
||||||
|
|
||||||
|
> Use this if like me, you'll be running this on an old Android phone running Termux that stays at your home
|
||||||
|
|
||||||
|
### On the Builder machine
|
||||||
|
|
||||||
|
Run `npm run build`
|
||||||
|
|
||||||
|
Then, copy `/data`, `/build`, `package.json`, `package-lock.json` and `.env` into a folder on the runner machine.
|
||||||
|
|
||||||
|
### On the Runner machine
|
||||||
|
|
||||||
|
In the folder in which you copied the files:
|
||||||
|
|
||||||
|
**Node version < 20.6** - Run:
|
||||||
|
|
||||||
|
- `npm ci --omit dev`
|
||||||
|
- `npm i dotenv`
|
||||||
|
- `node -r dotenv/config build`
|
||||||
|
|
||||||
|
**Node version >= 20.6** - Run:
|
||||||
|
|
||||||
|
- `npm ci --omit dev`
|
||||||
|
- `node --env-file=.env build`
|
||||||
|
</details>
|
||||||
|
|
||||||
|
## Original Usecase
|
||||||
|
|
||||||
|
I made this to turn on my gaming computer remotely when I'm away, and play it from Parsec on my laptop :3
|
||||||
|
|||||||
BIN
images/preview.png
Normal file
BIN
images/preview.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 149 KiB |
Loading…
x
Reference in New Issue
Block a user