docs: added proper readme

This commit is contained in:
axel 2025-04-21 13:45:43 +02:00
parent 3782f7b4fe
commit 6f9fd7170f
2 changed files with 62 additions and 5 deletions

View File

@ -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
![Preview of the panel](images/preview.png)
## 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

Binary file not shown.

After

Width:  |  Height:  |  Size: 149 KiB