HeliBoard 3.6

Changes since 3.6-beta3:
fix issue with Firefox workaround for other issues (
#2133
)

HeliBoard

HeliBoard is a privacy-conscious and customizable open-source keyboard, based on AOSP / OpenBoard. Does not use internet permission, and thus is 100% offline.

Table of Contents

Features

Contributing

Reporting Issues

Translations

To Community Creation

Code Contribution

License

Credits

Features

Add dictionaries for suggestions and spell check

build your own, or get them

here

, or in the

experimental

section (quality may vary)

additional dictionaries for emojis or scientific symbols can be used to provide suggestions (similar to "emoji search")

note that for Korean layouts, suggestions only work using

this dictionary

, the tools in the dictionary repository are not able to create working dictionaries

Customize keyboard themes (style, colors and background image)

can follow the system's day/night setting on Android 10+ (and on some versions of Android 9)

can follow dynamic colors for Android 12+

Customize keyboard

layouts

(only available when disabling

use system languages

)

Customize special layouts, like symbols, number, or functional key layout

Multilingual typing

Glide typing (

only with closed source library

☹️)

library not included in the app, as there is no compatible open source library available

can be extracted from GApps packages ("

swypelibs

"), or downloaded

here

(click on the file and then "raw" or the tiny download button)

Clipboard history

One-handed mode

Split keyboard

Number pad

Backup and restore your settings and learned word / history data

For

FAQ

,

hidden features

and more information about the app and features, please visit the

wiki

Contributing ❤

Reporting Issues

Whether you encountered a bug, or want to see a new feature in HeliBoard, you can contribute to the project by opening a new issue

here

. Your help is always welcome!

Before opening a new issue, be sure to check the following:

Does the issue already exist?

Make sure a similar issue has not been reported by browsing

existing issues

. Please search open and closed issues. In case of feature requests you could also check the

FAQ

and

hidden features

.

Is the issue still relevant?

Make sure your issue is not already fixed in the latest version of HeliBoard.

Is it a single topic?

If you want to suggest multiple things, open multiple issues.

Did you use the issue template?

It is important to make life of our kind contributors easier by avoiding issues that miss key information to their resolution. Note that issues that that ignore part of the issue template will likely get treated with very low priority, as often they are needlessly hard to read or understand (e.g. huge screenshots, not providing a proper description, or addressing multiple topics). Blatant violation of the guidelines may result in the issue getting closed.

If you're interested, you can read the following useful text about effective bug reporting (a bit longer read):

https://www.chiark.greenend.org.uk/~sgtatham/bugs.html

Translations

Translations can be added using

Weblate

. You will need an account to update translations and add languages. Add the language you want to translate to in Languages -> Manage translated languages in the top menu bar. Updating translations in a PR will not be accepted, as it may cause conflicts with Weblate translations.

Some notes on translations

when translating metadata, translating the changelogs is rather useless. It's available as it was requested by translators.

the

hidden_features_message

is horrible to translate with Weblate, and serves little benefit as it's just a copy of what's already in the wiki:

https://github.com/Helium314/HeliBoard/wiki/9.-Hidden-features

. It's been made available in the app on user request/contribution.

To Community

You can share your themes, layouts and dictionaries with other people:

Themes can be saved and loaded using the menu on top-right in the

adjust colors

screen

You can share custom colors in a separate

discussion section

Custom keyboard layouts are text files whose content you can edit, copy and share

this applies to main keyboard layouts and to special layouts adjustable in advanced settings

see

layouts.md

for details

You can share custom layouts in a separate

discussion section

Creating dictionaries is a little more work

first you will need a wordlist, as described

here

and in the repository readme

the you need to compile the dictionary using

external tools

the resulting file (and ideally the wordlist too) can be shared with other users

note that there will not be any further dictionaries added to this app, but you can add dictionaries to the

dictionaries repository

Code Contribution

See

Contribution Guidelines

License

HeliBoard (as a fork of OpenBoard) is licensed under GNU General Public License v3.0.

Permissions of this strong copyleft license are conditioned on making available complete source code of licensed works and modifications, which include larger works using a licensed work, under the same license. Copyright and license notices must be preserved. Contributors provide an express grant of patent rights.

See repo's

LICENSE

file.

Since the app is based on Apache 2.0 licensed AOSP Keyboard, an

Apache 2.0

license file is provided. The icon is licensed under

Creative Commons BY-SA 4.0

. A

license file

is also included.

Credits

Icon by

Fabian OvrWrt

with contributions from

The Eclectic Dyslexic

OpenBoard

AOSP Keyboard

LineageOS

Simple Keyboard

Indic Keyboard

FlorisBoard

Our

contributors