Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Trugamr/wol
CLI tool to send Wake-on-LAN magic packets and wake up network devices.
https://github.com/Trugamr/wol
cli go magic-packet network-discovery wake-on-lan
Last synced: 3 days ago
JSON representation
CLI tool to send Wake-on-LAN magic packets and wake up network devices.
- Host: GitHub
- URL: https://github.com/Trugamr/wol
- Owner: Trugamr
- License: mit
- Created: 2024-08-03T04:25:34.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-01-19T08:34:04.000Z (8 days ago)
- Last Synced: 2025-01-19T09:28:29.771Z (8 days ago)
- Topics: cli, go, magic-packet, network-discovery, wake-on-lan
- Language: Go
- Homepage:
- Size: 5.86 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- starred - Trugamr/wol - 🦠Wake up your devices with a single command or click. A Wake-On-LAN tool that works via CLI and web interface. (Go)
README
# wol ðŸ¦
A CLI tool to send Wake-On-LAN (WOL) magic packets to wake up devices on your
network. Features both CLI commands and a web interface.
## Features
- Send WOL magic packets via CLI or web interface
- Configure multiple machines with names for easy access
- List configured machines
- Web interface for easy wake-up
- Docker support
## Installation
### Pre-built binaries
Download the latest release for your platform from the
[releases page](https://github.com/trugamr/wol/releases).
Available for:
- Linux (x86_64, arm64, armv7)
- macOS (x86_64, arm64)
- Windows (x86_64)
### Using Go
```sh
go install github.com/trugamr/wol@latest
```
### Using Docker
```sh
docker run --network host -v $(pwd)/config.yaml:/etc/wol/config.yaml ghcr.io/trugamr/wol:latest
```
Or using docker-compose:
```yaml
services:
wol:
image: ghcr.io/trugamr/wol:latest
command: serve # To start the web interface
network_mode: "host"
volumes:
- ./config.yaml:/etc/wol/config.yaml
```
> [!NOTE]
> The config file should be mounted to `/etc/wol/config.yaml` inside the
> container. Host networking is recommended for Wake-on-LAN packets to work
> properly on your local network.
## Configuration
Create a `config.yaml` file in one of these locations (in order of precedence):
- `./config.yaml` (current directory)
- `~/.wol/config.yaml` (home directory)
- `/etc/wol/config.yaml` (system-wide)
Example configuration:
```yaml
machines:
- name: desktop
mac: "00:11:22:33:44:55"
ip: "192.168.1.100" # Optional, for status checking
- name: server
mac: "AA:BB:CC:DD:EE:FF"
ip: "192.168.1.101" # Optional, for status checking
server:
listen: ":7777" # Optional, defaults to :7777
```
## Usage
### CLI Commands
```sh
# List all configured machines
wol list
# Wake up a machine by name
wol send --name desktop
# Wake up a machine by MAC address
wol send --mac "00:11:22:33:44:55"
# Start the web interface
wol serve
# Show version information
wol version
```
### Web Interface
The web interface is available at `http://localhost:7777` when running the serve
command. It provides:
- List of all configured machines
- One-click wake up buttons
- Real-time machine status monitoring (when IP is configured)
- Version information
- Links to documentation and support
## Building from Source
```sh
# Clone the repository
git clone https://github.com/trugamr/wol.git
cd wol
# Build
go build
# Run
./wol
```
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE.md)
file for details.
## Contributing
Contributions are welcome! Feel free to open issues or submit pull requests.