{"id":24822,"library":"wakeonlan","title":"pywakeonlan","description":"A small Python module for Wake-on-LAN (WoL). Sends magic packets to wake up remote machines. Current version is 3.1.0, with irregular releases.","status":"active","version":"3.1.0","language":"python","source_language":"en","source_url":"https://github.com/remcohaszing/pywakeonlan","tags":["wake-on-lan","network","magic-packet"],"install":[{"cmd":"pip install wakeonlan","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"No need to specify inner module; top-level import is sufficient.","wrong":"from wakeonlan.wakeonlan import send_magic_packet","symbol":"send_magic_packet","correct":"from wakeonlan import send_magic_packet"}],"quickstart":{"code":"from wakeonlan import send_magic_packet\n\n# Send WoL packet to a device with the given MAC address\nsend_magic_packet('aa:bb:cc:dd:ee:ff')\n\n# You can also specify the IP address and port\nsend_magic_packet('aa:bb:cc:dd:ee:ff', ip_address='192.168.1.255', port=9)\n\n# Works with IPv6 (requires wakeonlan >= 3.1.0)\n# send_magic_packet('aa:bb:cc:dd:ee:ff', ip_address='ff02::1')","lang":"python","description":"Basic usage: import the library and call send_magic_packet with a MAC address."},"warnings":[{"fix":"Upgrade to Python 3.7+.","message":"Python 3.6 support dropped in version 3.0.0.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Use Python 3.6+ (now 3.7+ for latest).","message":"Python 2 support dropped in version 2.0.0.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Ensure UDP port 9 (or chosen port) is open and broadcast is allowed on your network.","message":"Broadcast IP must allow UDP traffic on port 9 (or custom port). Firewalls may block it.","severity":"gotcha","affected_versions":"all"},{"fix":"Use standard colon-separated format for maximum compatibility: 'AA:BB:CC:DD:EE:FF'.","message":"MAC address format: accepted delimiters are ':' and '-', also 'xxxx.xxxx.xxxx' format (supported since v3.0.0).","severity":"gotcha","affected_versions":">=3.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run the script with sudo (Linux/Mac) or as Administrator (Windows). Alternatively, use the library's default UDP broadcast method (no raw socket typically needed).","cause":"Creating raw socket requires root/admin privileges on some systems.","error":"OSError: [Errno 13] Permission denied"},{"fix":"Upgrade to latest version: pip install --upgrade wakeonlan. Import using: from wakeonlan import send_magic_packet","cause":"Old version of wakeonlan (< 1.0.0?) or incorrect import path.","error":"AttributeError: module 'wakeonlan' has no attribute 'send_magic_packet'"},{"fix":"Use format like 'AA:BB:CC:DD:EE:FF' (colon-separated hexadecimal pairs).","cause":"MAC address uses invalid characters or wrong format.","error":"ValueError: invalid MAC address"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}