Repository navigation
Releases
v1.2.0-rc.4 - Reliable wake routing and Wi-Fi retries
A reliability and security update based on the 2026-11-15 technical review.
Changes since RC3
- One wake sender. The Wake button, widget, Quick Settings tile and
automations now share the same Android sender. When Wi-Fi is connected, the
packet is sent on Wi-Fi even if mobile data or a VPN is the default network. - Wi-Fi rules retry when their window opens. A rule triggered outside its
allowed time window, or during its cooldown, is checked again when the window
opens, as long as the phone is still on the same connection. Without
exact-alarm access Android can delay this check. - Faster ping scans. Ping uses ICMP sockets instead of starting a process per
address, so a full/22fits within the 30-second limit. Kernels that deny
ICMP sockets fall back to the previous method. - External integrations. An intent with a wrong token now always receives
rejected, even when the rule is paused. Apps using the correct token still
seedisabled. - Devices saved in the same millisecond receive distinct identifiers.
- The app no longer rewrites the encrypted archive at every start.
- New privacy notice.
- Build and CI: patched
fast-xml-parser(GHSA-474x-hrwr-fgx4), CI compiles the
instrumented tests, and GitHub Actions are pinned to commit SHAs.
The archive format, backup format and MacroDroid contract are unchanged.
This remains an Android prerelease. Real-device and background-delivery
validation limits described in RC2 still apply.
Wake routing verification
Multi-network behaviour has been tested on the emulator only and still needs
verification on physical hardware.
- Connect a phone to Wi-Fi without internet, keep mobile data enabled, and
capture the packet on the target LAN. - Repeat with a VPN active. Check both the configured destination and the
default broadcast. - Send from the device list, widget, tile and an automation. Verify the
destination, UDP port and packet contents on the LAN for each.
The expected maintainer certificate SHA-256 is
b28b8a226b2e27771f5ba5a276ed16b5235c1b3d764a802bc68610e69e284fe9.
The RC3 APK preparation guide describes the
same commands and output folders; replace rc.3 with rc.4 and the version codes
above.
v1.2.0-rc.3 - Refined Wi-Fi subnet controls
A focused interface refinement for Scan Hosts, based on feedback from RC2.
Changes since RC2
- Centered Use current Wi-Fi subnet directly below the subnet input.
- Replaced the primary accent fill with a neutral secondary-button style, a subtle
border and text consistent with Status in Device List. - Let the button width follow its label within the available screen width, with
centered text and a minimum 48 dp touch target. - Kept Scan as the primary action, with subnet selection grouped near its input.
Wi-Fi automations, scan results, diagnostics and backup behavior are unchanged.
This remains an Android prerelease; real-device and background-delivery validation
limits described in RC2 still apply.
The expected maintainer certificate SHA-256 is
b28b8a226b2e27771f5ba5a276ed16b5235c1b3d764a802bc68610e69e284fe9.
v1.2.0-rc.2 - Wi-Fi automations, smarter scans and diagnostics
This release candidate adds Wi-Fi automation, easier device discovery and richer
network diagnostics. It also improves encrypted backup reliability. Android 7+
is required; encrypted backup requires Android 8+.
New features
- Wi-Fi automations: wake a saved PC when the phone connects to a named Wi-Fi
network, or require an exact SSID as an extra condition on any automation.
Repeated connection events and brief reconnects are suppressed. Precise location,
location services and background location access are required where applicable. - Smarter discovery: detect the current Wi-Fi IPv4 subnet and add a discovered
host through a prefilled device form. The device MAC still needs to be entered. - Larger, cancellable scans: scan up to 1,024 addresses (/22-/32) with at most
16 concurrent probes and a 30-second limit. Progress and discovered hosts appear
during scanning, and cancellation/time limits preserve partial results. - Advanced diagnostics: run ten TCP or ICMP probes with individual durations,
response loss and an average over successful responses. Partial reports remain
visible when cancelled. Open Status > Advanced diagnostics. - Legacy IP recovery: on Android 7-9 only, a secondary collapsed section can
look for a unique MAC/IP association and ask before updating addresses. This
action is hidden on Android 10+ because ARP-table access is restricted.
Fixes and refinements
- Backup export validates and confirms the password, then encrypts the archive
before opening the save picker. Success is reported only after writing completes. - Wi-Fi trigger and SSID-condition fields survive encrypted backup/export/import;
imported automation rules remain disabled and runtime credentials are excluded. - Late diagnostic-progress replies no longer replace a completed report.
- Repeated IP recovery requests cannot queue overlapping scans.
- UI and Android resource/compatibility cleanups.
Validation and remaining limits
33 Jest tests and 29 Android instrumentation tests passed on an Android 15/API 35
emulator. TypeScript, ESLint and dependency regression checks passed. Android Lint
reported no errors; compatibility/deprecation warnings remain. Native C++ tests
cover validation, UDP packets, scan cancellation and deadlines. A 1,024-address TCP
scan took about 6.8 seconds on the emulator's reserved benchmark network; actual
phone and LAN performance varies.
Real-phone testing of wake delivery, battery restrictions/Doze, reboot, VPN and
legacy ARP recovery is still pending. Wi-Fi identity may be unavailable when Android
permissions or location services are disabled; automation then fails closed. A
submitted wake packet does not prove PC startup. This is a prerelease, not a stable
hardware-validated release. iOS remains an unsupported upstream scaffold.
Choose arm64-v8a for most current Android phones; other APKs support ARMv7,
x86 and x86_64. APKs must use the existing maintainer certificate for updates.
Embedded version: 1.2.0-rc.2; ABI versionCodes: 10020101-10020104.
See the network guide
and pre-release review.
v1.2.0-rc.1 - Scheduled wakes and external automations
v1.2.0-rc.1 - Scheduled wakes and external automations
The first release candidate for version 1.2.0, available as a pre-release for testing.
What's new
- A new Automation tab with guided setup for one-time wakes, weekly schedules and external events through MacroDroid.
- Native Android scheduling, day and time-window filters, a minimum interval between attempts, execution history and optional notifications.
- Enabling a rule also turns on the main Automatic wakes switch.
- MacroDroid integration with revocable tokens and event deduplication.
- A discreet reachability indicator and status checks after a manual wake.
- A floating + button in Device List.
- Encrypted backups now include automation rules. Imported rules remain disabled until explicitly re-enabled.
Validation and known limitations
Automated checks and the release build passed. An actual MacroDroid 6.0.11 macro was tested on Android 15 / API 35, verifying five correct magic packets, dynamic event IDs, duplicate suppression, global pause/resume and token revocation/reconnection.
Physical-phone testing, prolonged Doze, reboot behavior and waking a real PC still require validation. The MacroDroid acceptance test keeps the app process alive through instrumentation and does not establish background reliability across phones. Sending a wake packet does not confirm that the PC has started.
Wi-Fi triggers, SSID conditions, simplified network discovery, changed-IP recovery and advanced diagnostics are planned for later releases.
Installation
Choose arm64-v8a for most recent Android phones. Builds for armeabi-v7a, x86 and x86_64 are also available. APKs use the same signing certificate as previous releases and support updating without uninstalling the app. File checksums are provided in SHA256SUMS.txt.
v1.1.0
v1.1.0 — Widgets, encrypted backups and refreshed design
First feature release of this maintained fork, based on nellogan/AwakeOnLANMobile.
Added
- Android home-screen widgets and a Quick Settings tile to wake a saved PC.
- On-demand TCP reachability checks with separate PC address/port settings.
- Password-encrypted portable device backup and import (Android 8+).
Improved
- Header respects system-bar and display-cutout insets, with a 48×48 dp menu touch target.
- Standard local IPv4 broadcast fallback (
255.255.255.255) shared by the app and shortcuts; explicit destinations preserved. - Brief toast after successful Wake submission, with blocking alerts reserved for send errors.
- Saved devices appear at startup.
- Refreshed light and dark themes, turquoise accents, compact device cards and accessible touch targets.
- New app icon.
- Keystore-backed encrypted device storage, serialized saves and stricter native validation.
- Bounded, cancellable network scans and updated npm dependencies with security fixes.
Installation
Choose arm64-v8a for Pixel 9 and most recent Android phones. Android 7+ is required.
This fork uses a personal signing certificate. Updating another distribution may require uninstalling it first, which deletes local devices. Export a backup first when available. Future updates of this fork must use the same certificate.
Limitations
Wake-on-LAN requires compatible PC and network settings. Packet submission does not confirm boot; an unsuccessful status check does not prove a PC is off. Use a trusted LAN or VPN. Widget/tile use requires unlocking the phone. iOS is not supported by this release.
Validation
Release preparation: 19 JavaScript tests, 8 dependency regression tests, native C++ security tests and 6 Android widget tests (including local broadcast delivery) passed; TypeScript and lint checks passed with no errors; npm audit reported zero known vulnerabilities. Release APKs built successfully for all four architectures. Light/dark layouts, standalone release startup without Metro, and the header menu touch target in portrait/landscape were checked on a Pixel 9 emulator (QA copy signed with the development key only). The distribution APKs are signed with the maintainer certificate, with signatures, ZIP alignment and payload identity verified. Complete a final physical-device smoke test of the signed 1.1.0 APK before publication.
Source: https://github.com/lucabnt/AwakeOnLANMobile/tree/main
License: GPLv3. Original app and networking by nellogan.