-
Notifications
You must be signed in to change notification settings - Fork 4
Servers
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.
Advanced / Servers
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.
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.
- 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