Android App
Use the primary WakeLink client for device discovery, account sign-in, relay management, and one-tap wake actions.
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
./gradlew testUse 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. |
Device 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 device 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 device.
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 |
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.