Android App

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

Note
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

1 Open the project

Open clients/android/ in Android Studio.

2 Build or test

./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
TCPDirect local-network connection. Requires agent IP, EWSP token, and port 7625.
WSSRemote access through the relay. Requires relay URL, API token, and agent ID.

agent Discovery

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

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

The returned metadata is used to populate the agent 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 agent.

Supported Commands

CommandDescription
pingCheck whether the agent is reachable
infoFetch firmware and network information
wakeSend a Wake-on-LAN magic packet
rebootRestart the agent
otaTrigger an OTA firmware update
set_configUpdate agent configuration when supported by the firmware
Note
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