An open API service indexing awesome lists of open source software.

https://github.com/thelicato/wolwm

Wake-On-LAN Web Manager
https://github.com/thelicato/wolwm

Last synced: 7 months ago
JSON representation

Wake-On-LAN Web Manager

Awesome Lists containing this project

README

          

# WOLWM




wolwm Logo



**WOLWM (Wake-on-LAN Web Manager)** is an easy-to-use web application that allows you to remotely wake up devices on your local network using **Wake-on-LAN (WoL) magic packets**. With a clean UI and simple configuration, WOLWM makes it effortless to bring your computers online from anywhere.

## 🎯 Features

- 🌐 **Web-based Interface** – No need for CLI commands; manage Wake-on-LAN from a browser.
- ⚑ **Send Magic Packets** – Wake up devices remotely with a single click.
- πŸ“‹ **Device Management** – Save and manage multiple devices for quick access.
- πŸ”„ **Logging & History** – Track which devices were woken up and when.

## πŸ”§ Setup

### Option 1: Running with Docker (Recommended)

1. Clone the repository:
```sh
git clone https://github.com/thelicato/wolwm.git && cd wolwm
```
2. Install dependencies:
```sh
docker compose up -d
```

### Option 2: Manual (dev mode)

1. Clone the repository:
```sh
git clone https://github.com/thelicato/wolwm.git && cd wolwm
```
2. Run in dev mode:
```sh
task dev # You have to install all the dev requirements
```

## πŸš€ Usage

1. Open your browser and navigate to `http://localhost:5000` (or `http://localhost:5173` if running in dev mode)
2. Add your device(s) by specifying their MAC address and network broadcast IP.
3. Click "Wake" to send a magic packet!

## πŸ“· Screenshots
| ![Devices](./screenshots/devices.png) | ![Events](./screenshots/events.png) |
| ------------------------------------- | ---------------------------------- |
| Devices Page | Events Page |

## πŸ“Œ Prerequisites

To use WOLWM, ensure you have:

- A device with **Wake-on-LAN** enabled in BIOS and OS.
- A **web server** to host the app.
- **Network access** to the target devices (they should be in the same subnet or properly routed).

## πŸ“– Wake-on-LAN Explained

Wake-on-LAN (WoL) is a networking standard that allows you to remotely wake up a powered-off computer using a **magic packet** sent over the network. The system must support WoL, and it must be enabled in both BIOS/UEFI and OS settings.

## πŸ› οΈ Troubleshooting

- **Device not waking up?** Ensure WoL is enabled in BIOS and OS.
- **Magic packet not reaching the device?** Check firewall and network configurations.
- **Using a VPN?** Wake-on-LAN usually doesn’t work across different subnets without special routing.

## πŸ—οΈ Future Improvements

- Scheduled wake-ups & shutdowns.
- Add authentication

## πŸ“œ License

This project is licensed under the **MIT License**.

## ❀️ Contributing

Contributions are welcome! Feel free to open issues or submit pull requests on [GitHub](https://github.com/thelicato/wolwm).