Android App

Use the primary WakeLink client for device discovery, account sign-in, relay management, and one-tap wake actions.

💡Tip

What you'll do: install the APK or build from source, sign in, add agents, and send one-tap wake commands from the app.

Requirements

  • Android Studio Hedgehog or newer for development
  • NDK 25+
  • CMake 3.18+
  • Android API 24+ (Android 7.0)

Build

1Open the project

Open clients/android/ in Android Studio.

2Build or test

bash
./gradlew test

Use Build → Make Project inside Android Studio to compile the app. The native libewsp_core.so library is built automatically through CMake.

Transport Modes

ModeDetails
TCP
Direct local-network connection. Requires agent IP, EWSP token, and port 7625.
WSS
Remote access through the relay. Requires relay URL, API token, and agent ID.

Device Discovery

On the local network, the app discovers agents and queries the HTTP status action used by WakeLink provisioning tools:

http
GET http://<agent-ip>/api/info

The returned metadata is used to populate the device list and simplify local TCP setup.

Authentication

The login screen supports three methods:

  1. Username and password
  2. Telegram login
  3. Browser login through a Custom Tab

The app never sends plaintext wake payloads to the relay. Commands are encrypted before they leave the device.

Supported Commands

CommandDescription
ping
Check whether the agent is reachable
info
Fetch firmware and network information
wake
Send a Wake-on-LAN magic packet
reboot
Restart the agent
ota
Trigger an OTA firmware update
set_config
Update agent configuration when supported by the firmware
💡Tip

To find a MAC address, run ipconfig /all on Windows or ip addr on Linux and macOS.

Project Layout

DirectoryStatus
android/
Current production Android client
multiplatform/
Experimental Kotlin Multiplatform port

Use android/ for production deployments.

Continue reading