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
|
||||
- make user dropdown work with keyboard navigation
|
||||

|
||||
|
||||
## Features
|
||||
|
||||
- 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