wol Felix Cusson
winget install --id=DarkfullDante.wol -e a CLI tool to send a wake-on-lan command to a locally attached device
Wol is a command-line interface (CLI) tool designed to send wake-on-LAN commands to locally attached devices using the wake-on-LAN magic packet protocol. It simplifies the process of waking up devices that support wake-on-LAN functionality.
Key Features:
- Cross-platform compatibility, supporting Windows and other operating systems.
- Lightweight design with minimal resource usage.
- Ability to send wake-on-LAN commands to multiple devices at once.
- Open-source and MIT licensed for transparency and flexibility.
Audience & Benefit: Ideal for network administrators and IT professionals who need a reliable tool to manage device wake-up processes. Wol reduces downtime and streamlines operations by enabling quick and efficient wake-up of connected devices.
Wol can be installed via winget, making it easy to integrate into your existing workflow.
README
wol
a windows wake-on-lan utility to wake a locally attached device using wake-on-lan magic packet protocol.
Installation
Winget (recommanded)
type the following command in a windows terminal > winget install DarkfullDante.wol
Installer
- Download the most recent release (wol_setup.exe)
- Run the installer
Manual
- Clone the repo
- Place the file /wol/bin/publish/wol.exe in your folder of choice
- Add the location of wol.exe to your environnement variable (PATH) for access from anywhere in cmd/powershell
- Call the application from its folder ([location]\wol.exe) or from PATH if step 3 was done (wol.exe)
Usage
The structure of the commands for the tool is has followed:
> wol [OPTIONS...]
Options
| Option | Required | Description |
|---|---|---|
| -a --address=VALUE | The address to reach the device. Defaults to broadcast (255.255.255.255). Can be IPv4, IPv6 or hostname | |
| -m --mac=VALUE | * | The mac address used to build the magic packet |
| -p --port=VALUE | The port to use to send the magic packet. Defaults to 7 | |
| -d --debug-level=VALUE | Verbosity level of the application (0 = silent, 1 = default, 2 = debug) | |
| -s --silent | Force the app in silent mode (no text in terminal), equivalent to -d=0 | |
| -v --version | Shows the installed version of the app | |
| -h --help | Show the help dialog of the app |
A mac address must be provided for the utility to work. All other fields are optional
Exemples
Minimal run
# an obviously inexistent mac address
> wol -m="00:00:00:00:00:00"
with ip
# an obviously inexistent mac address
> wol -a="192.168.0.230" -m="00:00:00:00:00:00" -p=9
hostname
# an obviously inexistent mac address
> wol -a="hostname.local" -m="00:00:00:00:00:00" -p=9
Contributing
Go ahead and make a pull request if you want to contribute.