Quick Start

The WakeLink Android app is the primary first-party client for sending wake commands. It requires Android 7.0 (API 24) or higher.

1. Visit the Downloads page
2. Tap Download APK on your Android device
3. Open the downloaded wakelink.apk
4. Allow installation from unknown sources if Android prompts you
5. Tap Install

1. Open the WakeLink app or visit the registration page in your browser
2. Create an account with your email address and password
3. Sign in and keep the dashboard open for the next steps

The ESP32 agent needs your relay connection details before it can come online.

1. Open the WakeLink dashboard
2. Navigate to Agents → Register New Agent
3. Create an agent entry such as "ESP32 Living Room"
4. Click Export Config and keep the downloaded values nearby
5. Keep the per-agent relay token (wld_…, api_agent_token) returned during agent creation available for provisioning

relay_url:   wss://wakelink-project.org/wss
agent_id:    esp32-living-room
agent_token: your-ewsp-secret

Download wakelink-esp32.bin from the Downloads page, connect the board over USB, then flash it with esptool:

pip install esptool

# Linux / macOS
esptool.py --chip esp32 --port /dev/ttyUSB0 --baud 460800 write_flash 0x0 wakelink-esp32.bin

# Windows (adjust COM port number)
esptool.py --chip esp32 --port COM3 --baud 460800 write_flash 0x0 wakelink-esp32.bin

After flashing, the device starts its provisioning hotspot.

1. Connect to the Wi-Fi network named WakeLink-Setup
2. Use the AP password shown on the serial console on first boot
3. Open http://192.168.4.1 in a browser, or use the Android setup wizard
4. Fill in the provisioning form with your Wi-Fi settings and relay credentials
5. Click Save & Connect

WiFi SSID:      YourNetworkName
WiFi Password:  YourNetworkPassword
Server Host:    wakelink-project.org
Server Port:    443
Use TLS:        enabled
Agent ID:       esp32-living-room
Agent Token:    your-ewsp-secret
API Token:      wld_your_device_relay_token

The LED blinks slowly while the AP is active, then turns solid once the agent is connected to Wi-Fi and the relay.

Now register the target computer in the dashboard.

1. Find its MAC address
2. Open the WakeLink dashboard
3. Click Add Device
4. Enter a friendly name and the MAC address
5. Select the ESP32 agent you just provisioned
6. Save the device entry

# Windows
ipconfig /all

# Linux
ip link show

# macOS
ifconfig en0 | grep ether

1. Power off the target computer completely
2. Open the WakeLink Android app
3. Sign in with your account
4. Tap Wake next to the device you added
5. Wait a few seconds for the computer to power on

Wake requests are created by the client and sealed with EWSP before they cross the relay.