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
| Mode | Details |
|---|---|
| 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. |
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/infoThe returned metadata is used to populate the agent list and simplify local TCP setup.
Authentication
The login screen supports three methods:
- Username and password
- Telegram login
- 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
| Command | Description |
|---|---|
| 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 |
Note
To find a MAC address, run
ipconfig /all on Windows or ip addr on Linux and macOS. Project Layout
| Directory | Status |
|---|---|
| android/ | Current production Android client |
| multiplatform/ | Experimental Kotlin Multiplatform port |
Use android/ for production deployments.