#wol #wake-on-lan #packets #magic #broadcasting #sending #mac

wakey

Wake-on-LAN library for creating and sending magic WOL packets

7 releases

0.3.0 Jan 6, 2023
0.2.2 Jun 26, 2022
0.1.2 Aug 20, 2019
0.1.1 Feb 4, 2019

#3 in #broadcasting

Download history 34/week @ 2024-11-13 22/week @ 2024-11-20 28/week @ 2024-11-27 46/week @ 2024-12-04 98/week @ 2024-12-11 77/week @ 2024-12-18 41/week @ 2024-12-25 21/week @ 2025-01-01 57/week @ 2025-01-08 66/week @ 2025-01-15 28/week @ 2025-01-22 37/week @ 2025-01-29 54/week @ 2025-02-05 72/week @ 2025-02-12 22/week @ 2025-02-19 30/week @ 2025-02-26

187 downloads per month

MIT license

10KB
181 lines

Wakey

Rust Crates.io docs.rs codecov

Library for managing Wake-on-LAN packets. It supports:

  • creating magic packets,
  • broadcasting them via UDP.

Usage

From string representation of MAC address and using defaults when broadcasting:

let wol = wakey::WolPacket::from_string(&mac_adress, sep)?;
if wol.send_magic().is_ok() {
    println!("Sent the magic packet.");
} else {
    println!("Failed to send the magic packet.");
}

Packets can also be constructed with raw bytes and sent from / to custom addresses:

use std::net::SocketAddr;

let wol = wakey::WolPacket::from_bytes(&[0x00, 0x01, 0x02, 0x03, 0x04, 0x05])?;
let src = SocketAddr::from(([0,0,0,0], 0));
let dst = SocketAddr::from(([255,255,255,255], 9));

wol.send_magic_to(src, dst)?;

Included binary

cargo run --bin wakey-wake 00:11:22:33:44:55

lib.rs:

Library for managing Wake-on-LAN packets.

Example

let wol = wakey::WolPacket::from_string("01:02:03:04:05:06", ':').unwrap();
if wol.send_magic().is_ok() {
    println!("Sent the magic packet!");
} else {
    println!("Failed to send the magic packet!");
}

Dependencies

~89KB