wavekey Mobile App Guide
How to use the wavekey app on iOS and Android: enroll your device, emit ultrasonic codes, and authenticate hands-free.
What is wavekey?
wavekey lets you authenticate with nearby devices by broadcasting an ultrasonic one-time code from your phone speaker. It's silent, secure, and hands-free.
Getting Started: Enrolling Your Device
Scan a QR Code
- Tap the QR code button (bottom-right corner).
- Point your camera at the enrollment QR code displayed when you first log in to wavekey on your browser.
- If a PIN is required, your organization admin will have received a 4-digit verification PIN by email. Enter it when prompted.
- A green checkmark confirms the scan, and your email is automatically set.
Camera Permission
The app will ask for camera permission the first time you scan. You must allow this for QR scanning to work.
Emitting an Ultrasonic Code
- Make sure your email is saved (the field at the top should show your email).
- Tap the large speaker button in the center of the screen.
- The status will change to "Emitting…" and animated rings will appear around the button.
- Tap the button again to stop emitting.
Email Required
If you try to emit without saving your email first, the email field will flash red. Enter and save your email, then try again.
Volume & Speaker Behavior
- wavekey uses your device's loudspeaker (not the earpiece) to broadcast.
- The emission volume is set automatically by the app; you don't need to adjust it manually.
- Headphones / AirPods: The ultrasonic code is designed to be broadcast from the device speaker and should automatically route the audio through them.
- The ultrasonic code is inaudible to the human ear; you shouldn't hear anything during emission.
- wavekey supports background audio, so emission can continue even if you switch to another app.
Notifications
- On first launch, wavekey will ask for permission to send push notifications.
- Notifications are used to prompt you to emit — for example, when a linked device or access point needs to verify your identity.
- Tapping a notification will open the app and automatically start emitting — no extra steps needed.
- If you haven't saved your email yet when you tap a notification, you'll see an alert asking you to set it first.
Settings
Tap the gear icon (⚙) in the top-right corner to open Settings. Here you'll find:
| Option | Description |
|---|---|
| Current ID | Your enrolled email address. Tap to copy it to your clipboard. |
| Privacy Policy | Opens the Everlink privacy policy in your browser. |
| Support | Opens an email to contact@everlink.co for help. |
| Version | The app version and build number. |
Troubleshooting
| Issue | Solution |
|---|---|
| Emit button doesn't work | Make sure you've scanned the QR code and saved your email first. |
| QR code says "expired" or "already used" | Ask your admin to generate a fresh QR code. |
| PIN entry says "Too many attempts" | Ask your admin to restart the enrollment process. |
| Camera not working for QR scan | Go to your device settings, find wavekey, and enable Camera access. |
| Notification tap doesn't start emitting | Ensure your email is saved in the app. |
| Nearby device can't detect the code | Disconnect headphones/AirPods and make sure your speaker isn't muffled or covered. |
| No sound during emission | This is normal — the code is ultrasonic and inaudible to humans. |
QR Code Error Messages
| Message | What It Means |
|---|---|
| "Invalid QR code. Please request a new one." | The QR code is not recognized. Ask your admin for a new one. |
| "QR code has expired or has already been used." | Refresh the QR code on the admin side and scan again. |
| "Incorrect PIN. Please try again." | Re-enter the 4-digit PIN carefully. |
| "Too many incorrect attempts." | The PIN has been locked. Contact your admin to restart enrollment. |
| "This enrollment link has expired." | Go back and re-scan a fresh QR code. |