Send Magic Packets via UDP broadcast to wake up WoL-compatible computers on the local network. Manage host configurations through the script — no manual YAML editing needed.
Execution Rule
Run the user's requested command directly without pre-checking dependencies, environment variables, or configuration. If something is wrong, the script will fail with a clear error — check and fix only then.
Environment Variables
| Variable | Required | Description |
|---|---|---|
WOL_CONFIG_PATH |
❌ | Custom path to hosts.yaml (default: ~/.wmyskills/wake-on-lan/hosts.yaml) |
The script loads these from ~/.wmyskills/.env (shared across skills) automatically; a scripts/.env in the script directory takes priority if present. Use scripts/.env.example as the template — add the variables to ~/.wmyskills/.env, never overwriting an existing file.
Requirements
pip install pyyaml python-dotenv
Usage
Script: scripts/wol.py
Manage Hosts
# List all configured hosts
python scripts/wol.py list
# Add a host
python scripts/wol.py add my-pc AA:BB:CC:DD:EE:FF --ip 192.168.1.100
# Edit a host's fields
python scripts/wol.py edit my-pc --mac 00:11:22:33:44:55 --ip 192.168.1.10
# Remove a host
python scripts/wol.py remove my-pc
Wake a Host
# Wake by name (from host list)
python scripts/wol.py wake my-pc
# Wake with more packets (improves reliability on lossy networks)
python scripts/wol.py wake my-pc --count 5
# Wake by raw MAC address (no config needed)
python scripts/wol.py wake-mac AA:BB:CC:DD:EE:FF
# Wake by MAC with custom broadcast
python scripts/wol.py wake-mac AA:BB:CC:DD:EE:FF --broadcast 192.168.1.255 --port 9
Add Command Options
| Flag | Description |
|---|---|
--ip IP |
IP address (for display/reference) |
--broadcast BC |
Broadcast address (default: 255.255.255.255) |
--port PORT |
UDP port (default: 9) |
--count N |
Number of magic packets to send (default: 3) |
Wake / Wake-MAC Options
| Flag | Description |
|---|---|
--broadcast BC |
Override broadcast address |
--port PORT |
Override UDP port (default: 9) |
--count N |
Number of packets to send (default: 3; higher counts improve reliability) |
Edit Options
| Flag | Description |
|---|---|
--new-name NAME |
Rename the host |
--mac MAC |
Change MAC address |
--ip IP |
Change IP address |
--broadcast BC |
Change broadcast address |
--port PORT |
Change UDP port |
--count N |
Change packet count |
Output Format
All output is JSON:
{"success": true, "host": "my-pc", "mac": "AA:BB:CC:DD:EE:FF", "broadcast": "255.255.255.255", "port": 9, "packets_sent": 3, "message": "Magic packet sent to AA:BB:CC:DD:EE:FF (3x via 255.255.255.255:9)"}
On failure:
{"success": false, "error": "Host 'xyz' not found", "available_hosts": ["my-pc", "my-server"]}
Notes
- The target computer's network adapter and motherboard must support WoL and have it enabled in BIOS/UEFI.
- Magic Packet is a UDP broadcast — it stays within the local subnet. Cross-subnet WoL requires directed broadcast or relay configuration.
- Host configurations are stored in
~/.wmyskills/wake-on-lan/hosts.yamlby default. The script auto-creates this file on first run. - Dependencies: Python 3.8+,
pyyaml. Standard library sockets used for packet construction.