EMERALDAndroid guide🇲🇽 EspañolDocumentation
← Emerald documentation

Android setup · Step-by-step guide

The access that makes Emerald possible.

Emerald keeps live translations above calls and other apps. That takes Android permissions a typical translation app does not need. You decide whether to grant them, and you can revoke them later.

Why Emerald is different

Live translation needs to stay visible while you use WhatsApp, a video call, or another app. The Accessibility service lets you display and launch the floating layer without leaving that conversation; microphone access lets Emerald hear speech during a LIVE session. Together, these capabilities make Emerald much more useful than a translation screen you must open separately.

We distribute Emerald directly while testing this combination and explaining its permissions. Google Play does allow some apps with Accessibility services, but requires additional review and disclosures. Emerald’s absence from Play does not mean Google bans every comparable app.

Allow the APK to install

  1. Open your Emerald download link in Chrome or your preferred browser. Wait for the .apk file to finish downloading.
  2. Open the file from the download notification or Files app. If Android prompts you, choose Settings and turn on “Allow from this source” for the app that opened the APK.
  3. If the prompt does not appear, search Android Settings for “Install unknown apps.” Choose Chrome if Chrome opened the APK, or Files if Files opened it. Turn on “Allow from this source” only for that app.
  4. Return to the downloaded file and tap Install. Review any additional Android confirmation before continuing.

“Allow from this source” belongs to the browser or file manager, not to Emerald. You can turn it off again after installation. If another browser opened the file, choose that browser instead of Chrome. Google’s guide to installing from other sources.

If Android blocks the service

  1. Open Emerald’s guide, choose your language, and tap “Open Accessibility Settings.” In Settings → Accessibility, select Emerald and try to enable its service.
  2. If it turns on, continue to the floating layer in the next section. If you see “Restricted setting” or the switch is disabled, dismiss that notice. On some phones, “Allow restricted settings” may not appear until you try setting up the service first.
  3. Now open Settings → Apps → Emerald → three-dot menu (⋮) → “Allow restricted settings.” Confirm your identity if Android asks.
  4. Return to Settings → Accessibility → Emerald and turn on the service. Then follow the floating-layer step below.

“Allow restricted settings” is separate from “Install unknown apps”: the first permits enabling Emerald’s Accessibility service; the second lets Chrome or Files open an APK installer. Menus can vary by phone and Android version. Google’s official instructions.

Close the first overlay and return to the guide

  1. Once Android permits Emerald to be enabled, read its warning and confirm that you want the service on. Android shows broad warnings for this class of permission because an Accessibility service can be very powerful.
  2. If Emerald’s overlay appears immediately, the service is on. Tap “Close & continue setup” to dismiss the overlay and return to the guide. You do not need to start LIVE yet.

Emerald uses this service to display and control its own caption layer. It does not need to read messages, contacts, or screen text, or control the app underneath. You can turn the service off in Settings → Accessibility at any time. Google’s shortcut guide.

Microphone, license, and shortcut

  1. Back in the guide, allow microphone access when Emerald asks. This permission does not start a session by itself.
  2. Paste and save the license from your invitation. Follow the guide’s remaining steps.
  3. Assign Emerald an Accessibility button or shortcut gesture. Use it to open Emerald above a call or another app. Once the shortcut works, Emerald shows its normal Settings screen.

If you denied microphone access, open Settings → Apps → Emerald → Permissions → Microphone and change it there.

Updates are APKs too

Emerald checks for updates, downloads the APK, and verifies the file and signing certificate. Android still asks you to approve the final installation. If “Allow from this source” appears during an update, choose Emerald this time because Emerald opened the installer. Do not uninstall the app before updating; installing over it preserves your settings.

Android developer verification and any waiting period for an unverified developer are separate from “Allow restricted settings.” If Android shows a developer-verification block, consult Google’s current instructions and contact us before changing other security settings. Android developer verification.

Review each step

  • Install only from the link we provide. Do not accept an APK forwarded by someone you do not know.
  • You do not need to turn off Play Protect to install Emerald. If Play Protect shows a specific warning, read it before deciding and contact us if unsure.
  • You can turn off “Allow from this source” for Chrome or Files after installation.
  • You can revoke microphone access or the Accessibility service in Settings whenever you want; features that depend on them will stop working until you re-enable them.

Play Protect can scan apps installed outside Play and may ask to send the APK to Google for review. Keeping that protection on is reasonable. Learn about Play Protect.

Where did it stop?

I downloaded the APK but cannot install it

Check which app opened the file: Chrome, another browser, or Files. Enable “Allow from this source” only for that app and reopen the APK. Confirm you downloaded the Android build from our link.

Emerald is dimmed in Accessibility

Return to Settings → Apps → Emerald → ⋮ → Allow restricted settings. Then revisit Accessibility. On some phones, try opening the blocked service first so Android shows the reason it is unavailable.

Emerald installed, but I see no captions

Confirm that microphone access and the Accessibility service are on, your license is saved, and you tapped LIVE. Configure the Accessibility shortcut to open the layer over the call.

An update will not install

Do not uninstall the current version. Allow Emerald to “Install unknown apps” if Android asks, then retry from Emerald Settings. If it still fails, send us your phone model and the exact error text.

Need a hand? Write to hello@neatthink.com.