Skip to content

Servers

github-actions[bot] edited this page Sep 10, 2026 · 1 revision

The Servers screen is in the F-Droid edition only. It lists every address the keyboard calls: each online service, and each git repository it downloads files from. Point one at a mirror, or at a server you run yourself, and the keyboard calls that instead. Leave a field empty and the keyboard calls the service's own server, which is what a fresh install does.

The same fields also sit on each tool's own page, so the address for weather is under the Weather tool too. Both places edit one setting.

This screen exists because F-Droid marks an app TetheredNet when it depends on a service that can't easily be replaced, and doesn't when a simple setting can point the app at a self-hostable alternative. Every service here is replaceable that way, including the ones that are already free software.

The other editions show a note on this screen and never read these fields.

Options

Advanced / Servers

Repositories

Four downloads are plain files in git repositories. A copy of a repository on another host works the same way, as long as it holds the same files.

Repository What it's for By default
Language data Word lists, n-gram packs, emoji keyword dictionaries, Chinese and Japanese conversion dictionaries, and vocabulary packs github.com/wasi-master/wmkeyboard-data
Add-on repository The add-on repository listed on a fresh install, and the Noto Color Emoji font github.com/wasi-master/wmkeyboard-addon-repository
Key sound repository The key sound repository listed on a fresh install github.com/wasi-master/wmkeyboard-monkeytype-sounds
Espanso Hub hub.espanso.org package links pasted on the Snippets screen github.com/espanso/hub

For each one, Hosted on picks the kind of host, and the fields under it say where the repository is. Paste a repository link fills the fields in from a page address copied out of a browser, on any of these hosts. The line under the fields shows the address the files will come from.

Hosted on Files come from
GitHub raw.githubusercontent.com/OWNER/REPO/BRANCH/
Forgejo or Gitea (Codeberg, gitea.com, or your own) HOST/OWNER/REPO/raw/branch/BRANCH/
GitLab HOST/OWNER/REPO/-/raw/BRANCH/
SourceHut git.sr.ht/~OWNER/REPO/blob/BRANCH/
Bitbucket bitbucket.org/OWNER/REPO/raw/BRANCH/
HTTPS folder The folder address you type, with each file's path added

Details worth knowing:

  • A repository must be on https://. If a field is empty, the keyboard keeps using the default repository, and the screen says so.
  • Branch can be empty. GitHub and GitLab then use the repository's default branch; the others use main.
  • The Chinese and Japanese conversion dictionaries are checked against a checksum after they download, so a mirror must serve exactly the same files.
  • An Espanso Hub package name is looked up by listing the package's version folders. GitHub, Forgejo, Gitea and GitLab can list them. On SourceHut, Bitbucket or a plain folder, paste a direct link to the package file instead.
  • Moving the add-on or key sound repository adds the new address to Add-ons the next time you open it. The old entry stays until you remove it.
  • Use the default repository puts one repository back where a fresh install has it.

Services

Each row is a base address. The keyboard adds the same path it always does, so a server you point it at has to answer the same API. An address can start with http:// as well as https://, for a server on your own network. Anything that isn't an address yet is ignored, and the field says which server the keyboard uses until it is.

Section Service By default
Downloads Keyman keyboard catalogue https://api.keyman.com
Downloads Keyman keyboard downloads https://downloads.keyman.com
Downloads Noto animated emoji https://fonts.gstatic.com/s/e/notoemoji/latest
Translate LibreTranslate none, set it up to use it
Translate Google Translate, no key https://translate.googleapis.com
Translate Google Cloud Translation https://translation.googleapis.com
Web and image search SearXNG none, set it up to use it
Web and image search Brave Search API https://api.search.brave.com
GIFs and stickers MediaWiki, for photos and GIFs Wikimedia Commons
GIFs and stickers KLIPY https://api.klipy.com
GIFs and stickers GIPHY https://api.giphy.com
Photos Unsplash https://api.unsplash.com
Photos Pexels https://api.pexels.com
Wikipedia Wikipedia or another MediaWiki https://{lang}.wikipedia.org
Dictionary Free Dictionary API https://api.dictionaryapi.dev
Vocabulary lookups kaikki.org (Wiktextract) https://kaikki.org
Vocabulary lookups Wiktionary https://en.wiktionary.org
Weather Open-Meteo forecast https://api.open-meteo.com
Weather Open-Meteo place search https://geocoding-api.open-meteo.com
Currency rates currency-api, and its second server jsDelivr, then https://latest.currency-api.pages.dev
Currency rates Frankfurter https://api.frankfurter.dev
Currency rates ExchangeRate-API, Coinbase, CoinGecko their own servers
AI providers Ollama, LM Studio, another OpenAI-compatible service none, set them up to use them
AI providers Anthropic, OpenAI, Google Gemini, xAI, DeepSeek their own servers
Update check F-Droid repository https://f-droid.org

A few of these, in more detail:

  • Wikipedia reads {lang} as the language you search in. An address without it, such as your own wiki, is used for every language.
  • F-Droid repository can be any repository that serves F-Droid's package API. IzzyOnDroid does, at https://apt.izzysoft.de/fdroid.
  • The keyed services (Brave, KLIPY, GIPHY, Unsplash, Pexels, Google's translation and the AI providers) are here for a proxy or a service that copies their API. Each of those tools also has a free server of its own to use instead: SearXNG, a MediaWiki, LibreTranslate or Ollama.

Not in the list: Google Drive, Dropbox and OneDrive backups, which the F-Droid edition can't use at all. Backups to WebDAV, S3-compatible storage or a folder already take any address you give them.

See Network policy for what each service is sent, and when.

Clone this wiki locally