-
Notifications
You must be signed in to change notification settings - Fork 4
Network policy
The core typing engine has no network code anywhere in it. Prediction, autocorrect, gesture typing and layouts all behave the same with the radio off. A set of optional tools do reach the internet, each one only while you're actively using it. Automatic backup runs on a timer too, if you set one up. This page is the complete list of what goes where.
In the F-Droid edition every address on this page is a setting. Advanced / Servers lists each service and each download repository, and the same fields sit on each tool's own page. Point one at a mirror or at a server you run and the keyboard calls that instead; leave a field empty and it calls the service's own server. See Servers.
Every network-touching tool makes a plain HttpURLConnection request. No
analytics SDK, no ad network and no background sync sits underneath any of
it.
| Tool | Endpoint | Sends | Fires when |
|---|---|---|---|
| Translate |
translate.googleapis.com (no key) or translation.googleapis.com (with a key) |
the text you typed into the panel, up to 2,500 characters, plus the target language | as you type, about 400ms after you stop, only while the panel is open |
| GIF search |
api.klipy.com, api.giphy.com
|
your search text, or nothing for the trending feed | immediately when you open the panel (trending), then live as you type |
| Sticker search | same clients as GIF search | same | same |
| Reporting a GIF or sticker result | none of the app's own | nothing: it builds a mail draft naming the provider, your search term, and the result's id and URL | only when you tap Report in the long-press menu, and only your mail app sends it |
| Web search | api.search.brave.com |
your search query | only when you submit a search, never as you type |
| Image search | api.search.brave.com |
your search query | same (submit only) |
| Dictionary | api.dictionaryapi.dev |
one English word: your selection, or the word at the cursor | on panel open, if "Look up the word at the cursor" is on (the default); also on manual search |
| Wikipedia | wikipedia.org |
your search text or an article title | only when you search or open an article, never on panel open |
| Currency converter |
open.er-api.com, falling back to api.frankfurter.dev. The F-Droid edition starts from cdn.jsdelivr.net (currency-api, which uses latest.currency-api.pages.dev when jsDelivr fails) and falls back to api.frankfurter.dev. The source is yours to pick from those and api.coinbase.com
|
nothing identifying: it fetches the whole rate table, converted locally | on panel open, or the first time a smart chip sees an amount. In the F-Droid edition that chip waits for your tap unless Fetch rates as you type is on. Cached for hours, not fetched per conversion |
| Cryptocurrency prices |
api.coinbase.com, falling back to cdn.jsdelivr.net; the F-Droid edition uses cdn.jsdelivr.net alone. api.coingecko.com is the other choice |
nothing identifying: it fetches prices for the coins you have turned on, converted locally | only when you type a coin amount or select a coin on the panel, never on a plain panel open. In the F-Droid edition a typed amount waits for a tap on its chip. Cached for a few minutes |
| Weather |
api.open-meteo.com, geocoding-api.open-meteo.com
|
the location you typed or searched, or nothing beyond a saved lat/long | on panel open, cached for a while, or when a weather chip needs a forecast (in the F-Droid edition that chip waits for your tap unless Fetch the forecast as you type is on); geocoding only fires while you're editing the location |
| AI (cloud provider) | the provider you picked, on its own API: Anthropic, OpenAI, Gemini, Grok (xAI) or DeepSeek | the text you ran the action on, plus a system prompt | only when you tap an action, never in the background |
| AI (any other OpenAI-compatible service) | whatever address you type in, for instance OpenRouter, Groq, Together or Mistral | same | same |
| AI (self-hosted Ollama or LM Studio) | a server address you enter on your own network | same | same, over plain HTTP |
| AI (on-device) | none | nothing leaves the phone | never: this provider has no network path at all |
| Reporting an AI result | none of the app's own | nothing: it builds a mail draft and hands it to your mail app | only when you tap Report, and only your mail app sends it |
| Clipboard link previews | whatever URL you copied | a GET request to that page | off by default; when on, right after you copy a new link |
| QR scan link previews | whatever URL a scanned code contains | a GET request to that page | off by default; when on, right after a QR code decodes to a URL |
| Voice typing (system recognizer) | Android's platform speech service (not WM Keyboard's own code) | your speech audio | whenever the on-device model for that language isn't installed: always, below Android 12 |
| Voice typing (Whisper) | none | nothing leaves the phone during dictation | never: fully offline once the model is downloaded |
The AI panel's Report button is the one row that quotes your own text without any network of its own. It opens a draft in your mail app holding the generation and the text it ran on, and you read and send it, or don't. See Reporting a result.
A few of these are worth calling out. GIF and sticker search fetch a
trending feed the instant you open the panel, before you've typed anything.
See GIFs for that behavior in full. Currency and weather are
the two tools that touch the network without you typing a query first.
Neither sends anything you typed. Currency pulls a public rate table and
converts locally, and weather sends only the location you already saved or
searched. Voice typing's network path isn't literally WM Keyboard's own HTTP
code, since it's Android's SpeechRecognizer used as a silent fallback, but
audio still leaves the device that way. See Voice typing
for the full breakdown, or Offline voice (Whisper) for
the fully on-device alternative.
Photo backgrounds are not a toolbox tool, but they do reach the network, so they belong in this list. Open the picker, type a word, and that word goes to Unsplash and Pexels along with the subject, color and orientation filters. Nothing else about you goes with it. Thumbnails load from each service's own servers rather than being copied through anything of ours, which is how a photographer is credited with the view. Choosing a photo downloads that one file at keyboard size, and tells Unsplash once that it was taken, which is how its download counts stay honest. A rotating background is the one part that fetches without you watching. It tops up a small set of photos as the keyboard closes, never while you type, and skips that entirely while the device is locked, under power saving, on mobile data unless you allow it, and when High contrast keys is on. See Online photos and rotation.
Everything else in the toolbox is offline by design: OCR, QR/barcode scanning, document scanning, the calculator, unit converter, symbols picker, password generator, QR code generation, grammar and spell-check, the camera tool, and every calendar/alt-calendar/qibla/moon-phase/solar-time feature. See Scanner and Utility tools for their own confirmations of that.
"Google Translate" is really two different endpoints, and it's worth being
precise about which one you're using. With no key, WM Keyboard calls
translate.googleapis.com, the same unofficial public endpoint browser
translate extensions use. That's fine for personal volumes, but it's
rate-limited and carries no uptime guarantee. Add a Cloud Translation API
key and it switches to translation.googleapis.com, the official, billed
Google Cloud API. See Translate for that switch
in detail.
The full set of third-party hosts a WM Keyboard install can reach, beyond what's already in the table above:
-
api.github.com, on a build downloaded from the project's GitHub releases, is where the update check asks what the newest release is. It runs at most once every six hours, and only while you have the settings app open. The request carries nothing but a version string identifying the app, and it is a conditional request, so an unchanged list of releases sends no data back and costs nothing against the limit GitHub applies to everyone sharing your IP address. Press Download and the APK comes fromgithub.com(which redirects toobjects.githubusercontent.com), andraw.githubusercontent.comserves the release notes when you press What's new. Play Store and F-Droid builds never make any of these requests. See Updating the app. -
f-droid.org, on an F-Droid build and no other, is asked what version F-Droid has, on the same six-hour schedule. That build downloads nothing: it can only point you back at the F-Droid client. -
raw.githubusercontent.com/wasi-master/wmkeyboard-datais the project's own data repository, source for downloadable dictionaries, word-pair (n-gram) packs, emoji keyword packs, and CJK conversion tables. See Downloads below. -
raw.githubusercontent.com/wasi-master/wmkeyboard-addon-repositoryis the sample addon repository, and also where the one-tap Noto Color Emoji font on the Emoji screen is fetched from (about 10 MB, plus a few hundred bytes of version manifest beside it). That one tap doesn't require adding a repository first. -
raw.githubusercontent.com/wasi-master/wmkeyboard-monkeytype-soundsis the second pre-added addon repository, a set of key-sound packs. Like the one above it is removable, and removing it is permanent. -
huggingface.cois the source for offline Whisper speech models and on-device AI models. Most are public. A couple of gated on-device models need your own Hugging Face account token. -
fonts.gstatic.comserves Google's Noto animated emoji. Long-press an emoji that has an animated version and the keyboard fetches a small WebP to loop in the popup, then fetches the full GIF when you tap Send. Nothing about you goes with either request. It only happens when Animated emoji is on and you're in a field that accepts images. See Animated emoji. -
Google's downloadable-font provider (
com.google.android.gms.fonts) supplies the Noto face the keyboard draws every non-Latin script in, and the Noto Color Emoji font choice arrives the same way. Play services makes that request, not the app, and nothing about you travels with it: a font is asked for by family name only. It happens the first time a script needs a face the device hasn't already cached, without you choosing anything. A device with no Play services falls back to the system font per glyph instead. -
Your backup destination, if you set one up. That's Google Drive
(
www.googleapis.com), Dropbox (www.dropbox.comto sign in, thenapi.dropbox.com,api.dropboxapi.comandcontent.dropboxapi.com), OneDrive (login.microsoftonline.comto sign in, thengraph.microsoft.com), or the S3, WebDAV or FTP server whose address you typed in yourself. Backups are off until you pick a destination, so none of these are contacted on a fresh install. What travels is your settings file and nothing else. See Backup & restore. - Whatever addon repository you add. Two are pre-added the first time you open the Addons screen, the two named above, but adding a reference doesn't fetch anything by itself. See Installing addons for when a repo actually gets contacted.
- Ollama and LM Studio are whatever address you point them at, with no fixed host. Traffic to a self-hosted server is plain HTTP, and the app allows cleartext traffic app-wide to support it, so keep that server on a network you trust. See AI tools for the full setup.
None of these services receive anything from WM Keyboard beyond the single request described for that tool, and there's no shared analytics identifier tying them together. Automatic backup is the one thing here that fires without you, and only to the destination you chose yourself.
Tools / Translate
Each tool that needs a key has its own field, all blank by default: Translate's Cloud Translation key, GIF search's Klipy and GIPHY keys, Web and Image search's Brave key, photo backgrounds' Unsplash and Pexels keys, and the AI tool's per-provider keys (Anthropic, OpenAI, Gemini, Grok, DeepSeek, and whatever key the OpenAI-compatible service you pointed it at wants) plus its Hugging Face token for gated on-device models. Leave any of them blank and that tool either falls back to a free endpoint (Translate) or shows a "needs an API key" state (GIF, search, AI). See each tool's own page under Tools for exactly where its field lives.
Every key you enter lives in the same place as the rest of your settings: a plain, unencrypted Android DataStore preferences file, protected by Android's normal app-sandboxed storage rather than by any extra encryption WM Keyboard adds on top.
Keys are excluded from a manual backup export unless you turn on Include API keys, and from Android's own device backup path they're excluded unconditionally. See Secrets stay out by default for the full export mechanics, including the exact warning text the app shows you.
One gap worth knowing about
Ollama and LM Studio server addresses aren't treated as secrets the way API keys are. They're not excluded from a manual export, even with "Include API keys" off. That's usually just a LAN address, but if you've folded a token or password into that URL yourself, it travels in plain exports. Keep that in mind before sharing a backup file.
Every downloadable asset comes over HTTPS, but the integrity check behind it isn't uniform. Don't assume every download is checksummed just because some are.
| Download | Source | Integrity check | Confirms before using mobile data? |
|---|---|---|---|
| Dictionaries and wordlists | the project's GitHub data repository | none beyond the gzip stream's own format check | Only from the "download everything for this language" button, which asks while Data saver is on and its Downloads row is set to Ask each time (the default) |
| Emoji keyword packs | same data repository | none beyond decode success | Same button, same setting |
| CJK conversion tables (pinyin, kana, stroke, cangjie, jyutping) | same data repository | SHA-256 verified before the file is used | No |
| Offline Whisper speech models | Hugging Face | no checksum, a file-size floor only | Yes, around 150 MB. See Offline voice (Whisper) |
| On-device AI models | Hugging Face, per model | no checksum, a file-size floor only | Yes, at 500 MB. See AI tools |
| Addons (themes, icon packs, plugins, sounds, layouts, sticker packs) | whichever repository you added | SHA-256 verified when the manifest supplies one, and mandatory for plugins specifically, since they run code | No |
| Addon repository manifests themselves | the repository URL you added | none: it's the trust root, so there's nothing to check it against. Capped at a fixed size instead | No |
| App updates (GitHub builds only) | this project's GitHub releases | SHA-256 verified against the checksum published in the release, and then the APK's signing key is compared against the key your install is signed with. A release with no checksum is refused rather than installed on trust | Yes, and it names the size before it starts |
Only CJK packs, app updates, and addons with a declared hash get cryptographic verification. Wordlists, emoji packs, Whisper models, and on-device AI models rely on HTTPS transport integrity plus a basic size check rather than a checksum. That's worth knowing if you're deciding how much to trust a third-party addon repository versus the project's own data feed. See Installing addons for how that mandatory plugin checksum is enforced.
Everything above is WM Keyboard's own code making its own request. Three Google libraries the app is built on top of talk to Google on their own schedule, and this is the honest list of them. None of them can see what you type. None of them can be switched off from inside the app either, so the choice is whether to use the feature.
| Component | In which build | Reaches Google when | What it sends |
|---|---|---|---|
| ML Kit (handwriting, OCR, QR/barcode scanning, document scanning, sticker background removal) | full edition only | when you use one of those features | Per Google's own disclosure: device make, model, OS build and available ML accelerators; the app's package name and version; a per-install identifier; latency figures, the API settings and input/output sizes; the SDK version, the kind of event (init, model download, detection) and any error codes. Google describes this as diagnostics and usage analytics, says it's encrypted in transit and not passed to third parties, and provides no switch to disable it. |
| Downloadable fonts | every build with Play services present | the first time a script's default keyboard font is needed, and whenever you pick a Google font in the theme editor | the font family name and this app's package name, asked of the Play services font provider. Play services makes the actual request, not this app. |
| Play Store libraries (in-app updates, and the on-demand download of the on-device AI runtime) | Play Store builds only | on the update check, and when you first use an on-device AI model | the app's package and version, handled by the Play Store app that installed it |
On a Play Store build the update check is the only thing that library is asked, and it is asked only when the app can see that the Play Store installed this copy. Sideload a Play-flagged APK and the app doesn't ask at all, because the answer can only ever be a refusal.
Google Drive as a backup destination adds a fourth, but only if you connect it: signing in is a Google sign-in, and after that the app talks to Drive directly over ordinary HTTPS. Nothing is connected by default.
The lite edition ships no ML Kit at all, so the first row doesn't exist there, and the F-Droid build carries no Play Store libraries either. The font row is the one that survives everywhere. It's an AndroidX API talking to whatever font provider the device has, so a phone with Play services (or microG) on it has that path no matter which build you installed. A phone without one falls back to the bundled Noto faces and never asks anybody anything.
Tools
- Per-tool Enabled switch (default on for every tool, including the networked ones). Turning a tool off here, or from the "Enabled" toggle at the top of that tool's own settings screen, removes it from the toolbar, the toolbox, and its hardware leader-key letter all at once. A disabled tool can't be opened, so it can't reach the network.
Tools / Power saving
- Background network is on by default whenever Power Saving itself is active, and Power Saving is off by default. It stops the fetches that happen without you asking for them: clipboard link previews, QR scan link previews, and the dictionary's look-up-on-selection. Every tool you open by hand keeps working normally, translate, search and AI included. See Power saving for the complete list of what else it drops.
Advanced / Data saver
- Data saver is the network-shaped version of the same idea, and the one to reach for if what you're protecting is a data allowance rather than a battery. Each feature that fetches gets its own answer: allow it, ask first, or turn it off while the connection is metered. The fetches that happen on their own default to off, and the ones you start yourself default to asking, so a GIF grid on mobile data explains itself and offers a Use mobile data button rather than coming up empty. See Data saver for the full table.
There's no single "airplane mode for the keyboard" switch beyond those. The closest equivalent is turning off every networked tool individually, or turning every Data saver row off and leaving the manual switch on. The typing engine itself needs no switch at all, because prediction, autocorrect, gesture typing and layouts have no network code to disable in the first place.
- The in-app Privacy screen lists the tools, not the fetches. Its note names translate, weather, web search, image search, GIFs, stickers, dictionary lookup and the AI tools, and says the network is used only at the moment you press one. That covers the deliberate half. It leaves out the things that fetch on their own (currency chips, language data, link previews) and the download screens, which is what this page adds. See Data collection for the same note read from the storage side.
- AI's default provider needs a key before it does anything. Claude (Anthropic) is the pre-selected provider chip, but with a blank key, so the tool shows a "needs an API key" state out of the box rather than silently trying a provider that isn't configured.
- Currency and weather cache their results rather than fetching on every open. Currency holds for a few hours, coin prices for a few minutes, and weather for about fifteen minutes, so most opens after the first don't touch the network at all.
- Coin prices are fetched lazily. Cryptocurrency is on by default, but the coin source is only asked when you actually type a coin amount or pick a coin on the panel. If you never do, your keyboard never talks to it.
- Only one tool reads your field rather than its own search box. Translate, Wikipedia and both search tools send what you type into the panel, and nothing else: the translate panel is its own window and never looks at the field behind it. Dictionary is the exception, reading the selected or cursor word when auto-lookup is on.
- Addon repository manifests aren't fetched proactively. Seeding the two pre-added references doesn't contact them. A manifest only downloads when you actually open or refresh the Addons screen, which is also the visit that seeds them.
-
Cleartext traffic is allowed app-wide, not scoped to Ollama and LM
Studio specifically, which is what makes plain-HTTP requests to a
self-hosted AI server possible at all. It doesn't weaken HTTPS anywhere
the app picks the address: every tool in the table above is contacted over
HTTPS, and an addon repository URL on plain
httpis rejected rather than quietly upgraded. The two places a plain address is your own choice are the self-hosted AI server and an S3 backup endpoint you type withhttp://.
See Data collection for what the keyboard learns from you locally, and Backup & restore for how API keys and the rest of your settings move between devices.
- Home
- Getting started
- Typing
- Languages
- Suggestions & correction
- Emoji & expression
-
Tools
- Clipboard manager
- Voice typing
- Offline voice (Whisper)
- Handwriting
- Scanner (OCR, QR, documents)
- Camera tool
- Translate
- Search, Wikipedia & dictionary
- Media controls
- AI chat
- AI tools
- Utility tools
- Snippets & text expansion
- Text editing & cursor tools
- Instruments
- Trackpad
- Calendar
- App launcher
- Learn from text
- Vocabulary
- Resize the keyboard
- The toolbar
- Themes & appearance
- Addons
- Plugins
- Privacy & security
- Accessibility
-
Reference
- Gesture cheat sheet
- Typing
- Hardware shortcuts
- Deep links & launcher shortcuts
- Key press
- File formats
- Dictionaries & words
- Importing from other keyboards
- Languages
- Importing from Espanso
- Appearance
- Keyboard themes
- Troubleshooting
- Glossary
- Keyboard font
- Easter eggs
- Icons
- Layout & size
- Key layouts
- Rows & bars
- Keyboard modes
- Emoji
- Phone number formats
- Tools
- Addons & plugins
- Reference - Accessibility
- Fingerprint lock
- Reference - Data saver
- Reference - Permissions
- Privacy
- Reference - Selection actions
- Servers
- Reference - Backup & restore
- About & diagnostics
- Statistics
- Settings A–Z
- Development