Troubleshooting and FAQ
Why is my keyboard lagging so much?
On low-end devices, the Transformer LM may run too slowly. Try disabling the Tranformer LM setting and see if it improves. The language model system will be reworked in the future to prevent this from happening.
It’s too inconvenient to add words to personal dictionary
You shouldn’t need to manually add words to personal dictionary. Automatic word learning occurs under the following conditions:
- “Personalized suggestions” setting is enabled
- The current text field is a learnable text field (it has autocorrect enabled and hasn’t disabled learning explicitly)
- You have typed at least one word valid in current language (if multilingual typing is active, you must have a larger streak of valid words in one language than any other)
- You type a brand new word that’s not in the current dictionary
To test this in English, you can open FUTO Keyboard settings, tap “Try typing here” at the bottom, type “hello asdf asdf” and see if “asdf” starts to become suggested without a small underline below it.
Long pressing the period key is showing me a weird layout, or missing important symbols
The “Quick period key” will toggle between two modes of period key long pressed keys. When enabled, it will show them in this layout: ! , . ? and you can swipe the key to quickly insert one of those. Try disabling the toggle if that’s not what you want.
If quick period key is missing important characters for your language, please let us know so we can fix it.
Next word suggestions are not showing (non-English)
Next word suggestions outside of English are limited. You can download an experimental dictionary which will have next-word suggestions.
To view available dictionaries, go to FUTO Keyboard settings > Languages & Models > tap Dictionary on a chosen language > Explore
Dictionary is missing too many words or missing all words (non-English)
Make sure you have a dictionary downloaded and imported. The experimental ones may have more words.
To view available dictionaries, go to FUTO Keyboard settings > Languages & Models > tap Dictionary on a chosen language > Explore
Can I make voice input more accurate on my device?
Voice input accuracy can be influenced by various factors, but the main ones you can change are the model used and your personal dictionary.
FUTO Keyboard voice models can be downloaded at https://keyboard.futo.org/voice-input-models and opened with FUTO Keyboard. Larger models should be more accurate but run slower.
The personal dictionary can also be modified in the settings. In some cases disabling “Personal Dictionary for Voice” can actually improve quality if they’re generally acting as distractions for the model.
Other factors affecting voice input quality include microphone quality and location, background noise, speaking speed, enunciation. If you have a Bluetooth headset you can enable the use of its microphone in FUTO Keyboard, which will generally reduce background noise.
Voice input isn’t accurate enough for my language or accent even on the largest model, can I help somehow?
As a user, you can contribute to Mozilla’s Common Voice dataset. This is an open dataset which is currently lacking in a lot of languages, and you can help improve voice tech for everyone: https://commonvoice.mozilla.org/
As a developer, you can finetune a Whisper model on a dataset representative of your language or accent. There are some articles like https://huggingface.co/blog/fine-tune-whisper that have some information on finetuning. You will probably want to finetune whisper-base or small, the larger ones will be too large for mobile use. Once you have a finetuned model you will need to adapt it with https://github.com/futo-org/whisper-acft/ and then convert it to ggml .bin format with https://github.com/ggml-org/whisper.cpp/blob/master/models/convert-h5-to-ggml.py and then you should be able to just import it to FUTO Keyboard. If you’d like to distribute the model to more people then open an issue at https://github.com/futo-org/voice-input-models/issues and we may put it on the downloads page.
Can I help translate the app or fix translation errors?
Yes, you can translate here: https://i18n-keyboard.futo.org/
Japanese keyboard can’t type Kanji or Katakana
Ensure you have the Japanese dictionary downloaded and imported: https://keyboard.futo.org/dictionaries?locale=ja-JP
Without it, you can only type Hiragana letters and the keyboard will not be practical to use.
Accents or numbers are missing when I long-press keys
Please go to FUTO Keyboard settings > Keyboard & Typing > Long-press keys & spacebar > tap “Reset to default” on Layout of long-press keys. You may have deactivated the accents by accident via misclick. This setting will be reworked in the future to prevent this from happening.
When will GIF search be added?
GIF search is not on our roadmap for the following reasons:
- Unfortunately, the major GIF search platforms are not friendly towards privacy and there is no good one that we can get behind.
- Our goal is to keep the keyboard offline and not add unnecessary online functionality, especially if it’s unfriendly towards privacy.
- Most apps that support GIF input (e.g. messaging apps) already have a working GIF picker built-in, so an additional one in the keyboard is not really necessary.
We hope you can understand that for these reasons, this does not fit into the product we’re trying to build.
Where do I enter my license key?
FUTO Keyboard does not have a license key verification system due to being offline. If you have paid, then simply tap “I already paid” to confirm you’ve already paid. You can also tap the link emailed to you (FUTO Pay only), or tap the activate button in the payment app (Google Play only)
My issue isn’t covered or resolved by the above
Please contact keyboard@futo.org or open an issue on our GitHub issue tracker.