Send Wake on LAN packets using AMD's standard Magic Packet format. Scapy is used to build and send the WOL packets
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Wake On LAN


This library sends packets with scapy, which conform to AMD's Magic Packet spec. When a computer is in sleep mode, has the correct hw / config, and plugged into the network, a packet arriving on the NIC will trigger a process to wake it from its sleep mode.

Specifically, three packets are implemented:

  • udp4(): send the WOL event as an IPv4 broadcast packet, UDP port 9
  • raw(): send the WOL event as a raw ethernet packet to Ethertype 0x0847
  • udp6(): send the WOL event as an IPv6 packet to the all-hosts group (ff02::1), UDP port 9. ff02::1 was recommended by the Microsoft DLNA Interoperability guidelines

Only sending one of these packets is not guaranteed to wake a computer up; success depends on your PC's hardware. I've had the most success with udp4() and raw(); I have never even seen a computer wake up with udp6(). However, someone asked a question on the internet about using IPv6 to trigger Wake on LAN, and I wanted to see whether I could wake my computers up with an IPv6 WOL packet.

There are plenty of python implementations for WOL, but I couldn't find any that built all three packets (raw ethernet, IPv4 and IPv6). This project was just an experiment to see how IPv6 WOL would work.


It's pretty simple... build an instance of the WOL() object with the target mac address, and call whichever WOL function you like on the mac; you can optionally specify the egress interface as well (the default is eth0).

I bundled scapy with the module so it's mostly plug-and-play, assuming you have python2 on your linux machine and root priviledges.

Call this script as root to send all three WOL packets to mac-address 00:30:1b:b0:f7:7d...

# Add python imports here...

obj = wol.WOL("00:30:1b:b0:f7:7d", intf="eth0")