Skip to main content

wakeonlan

Pypi version Supported Python versions Build Status Documentation Status Code coverage

A small python module for wake on lan.

For more information on the wake on lan protocol please take a look at Wikipedia.

Installation

pip install wakeonlan

Usage

To wake up a computer using wake on lan it must first be enabled in the BIOS settings. Please note the computer you are trying to power on does not have an ip address, but it does have a mac address. The package needs to be sent as a broadcast package.

As a Python Module

Wake up a single computer by its mac address

import wakeonlan

wakeonlan.wake('ff.ff.ff.ff.ff.ff')

Wake up a single computer by its mac address with a SecureOn password

import wakeonlan

wakeonlan.wake('ff.ff.ff.ff.ff.ff/01:23:45:67:89:ab')

Wake up multiple computers by their mac addresses.

import wakeonlan

wakeonlan.wake(
    'ff.ff.ff.ff.ff.ff',
    '00-00-00-00-00-00',
    'FFFFFFFFFFFF'
)

An external host may be specified. Do note that port forwarding on that host is required. The default ip address is 255.255.255.255 and the default port is 9.

import wakeonlan

wakeonlan.wake('ff.ff.ff.ff.ff.ff',
    host='example.com',
    port=1337
)

A network adapter may be specified. The magic packet will be routed through this interface.

import wakeonlan

wakeonlan.wake(
    'ff.ff.ff.ff.ff.ff',
    interface='192.168.0.2'
)

As a Standalone Script

$ wakeonlan --help
usage: wakeonlan [-h] [-4] [-6] [-o HOST] [-p PORT] [-n INTERFACE] mac address [mac address ...]

Wake one or more computers using the wake on lan protocol.

positional arguments:
mac address           The mac addresses or "mac address/secureon password" tuples of the computers you are trying to wake.

options:
-h, --help            show this help message and exit
-o HOST, --host HOST  The host name to send the magic packet to. (default: 255.255.255.255)
-p PORT, --port PORT  The port of the host to send the magic packet to. (default: 9)
-n INTERFACE, --interface INTERFACE
                      The ip address of the network adapter to route the magic packet through. (default: None)
-4, --ipv4            To indicate ipv4 should be used. (default: False)
-6, --ipv6            To indicate ipv6 should be used. (default: False)

Compatibility

This project works with Python 3.10 or greater.

License

MIT © Remco Haszing

Metadata

Release files for wakeonlan 4.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wakeonlan 4.0.0
File Size Uploaded
wakeonlan-4.0.0.tar.gz 5.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for wakeonlan 4.0.0
File Interpreter ABI Platform
wakeonlan-4.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 11.0 kB

Release files / wakeonlan-4.0.0.tar.gz

Download URL wakeonlan-4.0.0.tar.gz
Size 5.1 kB
Tags Source
SHA-256 checksum
How to use checksums
1cb30c4ae60f85ef289f4f7d4f703382ed19ba84103206dc5e2b1e51bec9f456
BLAKE2b-256 checksum
How to use checksums
8f1669e4cdcce1be240667dfa2607f12e00d1c79e4606656327c4f1fb88fea40
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 28, 2026.

Transparency log

Release files / wakeonlan-4.0.0-py3-none-any.whl

Download URL wakeonlan-4.0.0-py3-none-any.whl
Size 5.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
82c50fe0c8dbc4848b8398f48fd2d2ed5d4af363f3006279372d76513ef84505
BLAKE2b-256 checksum
How to use checksums
5c80ecebf7b1b32ebe4a10d72a09e21c4c76a2460fac159752ec9ab88508b7d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 28, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

4.0.0 This release

2 release files

3.3.0

2 release files

3.1.0

2 release files

3.0.0

2 release files

2.1.0

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.1.6

2 release files

1.1.5

2 release files

1.0.0

2 release files

0.2.2

1 release file

0.2.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page