Skip to content

Commit 96aebad

Browse files
committed
Update README for HeliboardL fork with proper credits to original HeliBoard
1 parent 4cf3a84 commit 96aebad

1 file changed

Lines changed: 47 additions & 86 deletions

File tree

README.md

Lines changed: 47 additions & 86 deletions
Original file line numberDiff line numberDiff line change
@@ -1,110 +1,71 @@
1-
# HeliBoard
2-
HeliBoard is a privacy-conscious and customizable open-source keyboard, based on AOSP / OpenBoard.
3-
Does not use internet permission, and thus is 100% offline.
4-
5-
[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" alt="Get it on F-Droid" height="80">](https://f-droid.org/packages/helium314.keyboard/)
6-
[<img src="https://user-images.githubusercontent.com/663460/26973090-f8fdc986-4d14-11e7-995a-e7c5e79ed925.png" alt="Get APK from GitHub" height="80">](https://github.com/Helium314/HeliBoard/releases/latest)
7-
[<img src="https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroid.png" alt="Get it on IzzyOnDroid" height="80">](https://apt.izzysoft.de/fdroid/index/apk/helium314.keyboard)
8-
9-
## Table of Contents
10-
11-
- [Features](#features)
12-
- [Contributing](#contributing-)
13-
* [Reporting Issues](#reporting-issues)
14-
* [Translations](#translations)
15-
* [To Community Creation](#to-community)
16-
* [Code Contribution](CONTRIBUTING.md)
17-
- [License](#license)
18-
- [Credits](#credits)
19-
20-
# Features
1+
# HeliboardL
2+
3+
**HeliboardL** is a fork of [HeliBoard](https://github.com/Helium314/HeliBoard) - a privacy-conscious and customizable open-source keyboard based on AOSP/OpenBoard.
4+
5+
This fork adds **AI-powered features** using the Gemini API while maintaining the offline-first philosophy of the original.
6+
7+
## What's New in HeliboardL
8+
9+
- **🤖 Gemini AI Proofreading** - Fix grammar and spelling with one tap using toolbar key
10+
- **🌐 AI Translation** - Translate selected text via toolbar
11+
- **🎨 Enhanced Toolbar UI** - Squircle backgrounds for toolbar keys
12+
- **🕵️ Incognito Mode Indicator** - Subtle watermark on spacebar when incognito is active
13+
- **📥 Gesture Library Downloader** - Easier setup for glide typing
14+
15+
## Download
16+
17+
*Coming soon to GitHub Releases*
18+
19+
## Original HeliBoard Features
20+
2121
<ul>
2222
<li>Add dictionaries for suggestions and spell check</li>
23-
<ul>
24-
<li>build your own, or get them <a href="https://codeberg.org/Helium314/aosp-dictionaries#dictionaries">here</a>, or in the <a href="https://codeberg.org/Helium314/aosp-dictionaries#experimental-dictionaries">experimental</a> section (quality may vary)</li>
25-
<li>additional dictionaries for emojis or scientific symbols can be used to provide suggestions (similar to "emoji search")</li>
26-
<li>note that for Korean layouts, suggestions only work using <a href="https://github.com/openboard-team/openboard/commit/83fca9533c03b9fecc009fc632577226bbd6301f">this dictionary</a>, the tools in the dictionary repository are not able to create working dictionaries</li>
27-
</ul>
2823
<li>Customize keyboard themes (style, colors and background image)</li>
29-
<ul>
30-
<li>can follow the system's day/night setting on Android 10+ (and on some versions of Android 9)</li>
31-
<li>can follow dynamic colors for Android 12+</li>
32-
</ul>
33-
<li>Customize keyboard <a href="https://github.com/Helium314/HeliBoard/blob/main/layouts.md">layouts</a> (only available when disabling <i>use system languages</i>)</li>
34-
<li>Customize special layouts, like symbols, number, or functional key layout</li>
24+
<li>Customize keyboard layouts</li>
3525
<li>Multilingual typing</li>
36-
<li>Glide typing (<i>only with closed source library</i> ☹️)</li>
37-
<ul>
38-
<li>library not included in the app, as there is no compatible open source library available</li>
39-
<li>can be extracted from GApps packages ("<i>swypelibs</i>"), or downloaded <a href="https://github.com/erkserkserks/openboard/tree/46fdf2b550035ca69299ce312fa158e7ade36967/app/src/main/jniLibs">here</a> (click on the file and then "raw" or the tiny download button)</li>
40-
</ul>
26+
<li>Glide typing (<i>requires closed source library</i>)</li>
4127
<li>Clipboard history</li>
4228
<li>One-handed mode</li>
4329
<li>Split keyboard</li>
4430
<li>Number pad</li>
45-
<li>Backup and restore your settings and learned word / history data</li>
31+
<li>Backup and restore settings</li>
4632
</ul>
4733

48-
For [FAQ](https://github.com/Helium314/HeliBoard/wiki/FAQ), [hidden features](https://github.com/Helium314/HeliBoard/wiki/9.-Hidden-features) and more information about the app and features, please visit the [wiki](https://github.com/Helium314/HeliBoard/wiki)
49-
50-
# Contributing ❤
34+
For original feature documentation, visit the [HeliBoard Wiki](https://github.com/Helium314/HeliBoard/wiki).
5135

52-
## Reporting Issues
36+
## Setup
5337

54-
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](https://github.com/Helium314/HeliBoard/issues). Your help is always welcome!
38+
### Gemini API Key (for AI features)
39+
1. Get your free API key from [Google AI Studio](https://aistudio.google.com/apikey)
40+
2. Go to HeliboardL Settings → Advanced → Gemini API Key
41+
3. Enter your API key
5542

56-
Before opening a new issue, be sure to check the following:
57-
- **Does the issue already exist?** Make sure a similar issue has not been reported by browsing [existing issues](https://github.com/Helium314/HeliBoard/issues?q=). Please search open and closed issues. In case of feature requests you could also check the [FAQ](https://github.com/Helium314/HeliBoard/wiki/FAQ) and [hidden features](https://github.com/Helium314/HeliBoard/wiki/9.-Hidden-features).
58-
- **Is the issue still relevant?** Make sure your issue is not already fixed in the latest version of HeliBoard.
59-
- **Is it a single topic?** If you want to suggest multiple things, open multiple issues.
60-
- **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.
61-
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.
43+
### Gesture/Glide Typing
44+
Use the built-in gesture library downloader in Settings → Advanced → Load Gesture Typing Library.
6245

63-
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
46+
## Contributing
6447

65-
## Translations
66-
Translations can be added using [Weblate](https://translate.codeberg.org/projects/heliboard/). 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.
67-
Updating translations in a PR will not be accepted, as it may cause conflicts with Weblate translations.
48+
For issues specific to HeliboardL features, please open an issue in this repository.
6849

69-
Some notes on translations
70-
* when translating metadata, translating the changelogs is rather useless. It's available as it was requested by translators.
71-
* 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.
50+
For issues with core HeliBoard functionality, please report to the [original HeliBoard repository](https://github.com/Helium314/HeliBoard/issues).
7251

73-
## To Community
74-
There is the [discussions on GitHub](https://github.com/Helium314/HeliBoard/discussions), or if you prefer a more open network there is [Lemmy](https://lemmy.world/c/Heliboard).
75-
You can share your themes, layouts and dictionaries with other people:
76-
* Themes can be saved and loaded using the menu on top-right in the _adjust colors_ screen
77-
* You can share custom colors in a separate [discussion section](https://github.com/Helium314/HeliBoard/discussions/categories/custom-colors)
78-
* Custom keyboard layouts are text files whose content you can edit, copy and share
79-
* this applies to main keyboard layouts and to special layouts adjustable in advanced settings
80-
* see [layouts.md](layouts.md) for details
81-
* You can share custom layouts in a separate [discussion section](https://github.com/Helium314/HeliBoard/discussions/categories/custom-layout)
82-
* Creating dictionaries is a little more work
83-
* first you will need a wordlist, as described [here](https://codeberg.org/Helium314/aosp-dictionaries/src/branch/main/wordlists/sample.combined) and in the repository readme
84-
* the you need to compile the dictionary using [external tools](https://github.com/remi0s/aosp-dictionary-tools)
85-
* the resulting file (and ideally the wordlist too) can be shared with other users
86-
* note that there will not be any further dictionaries added to this app, but you can add dictionaries to the [dictionaries repository](https://codeberg.org/Helium314/aosp-dictionaries)
52+
## License
8753

88-
## Code Contribution
89-
See [Contribution Guidelines](CONTRIBUTING.md)
54+
HeliboardL (as a fork of HeliBoard/OpenBoard) is licensed under **GNU General Public License v3.0**.
9055

91-
# License
56+
See [LICENSE](/LICENSE) file.
9257

93-
HeliBoard (as a fork of OpenBoard) is licensed under GNU General Public License v3.0.
58+
## Credits
9459

95-
> 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.
60+
### Original Projects
61+
- **[HeliBoard](https://github.com/Helium314/HeliBoard)** by Helium314 - The excellent keyboard this fork is based on
62+
- [OpenBoard](https://github.com/openboard-team/openboard)
63+
- [AOSP Keyboard](https://android.googlesource.com/platform/packages/inputmethods/LatinIME/)
64+
- Original icon by [Fabian OvrWrt](https://github.com/FabianOvrWrt)
9665

97-
See repo's [LICENSE](/LICENSE) file.
66+
### HeliboardL
67+
- Built with ❤️ by [LeanBitLab](https://github.com/LeanBitLab)
9868

99-
Since the app is based on Apache 2.0 licensed AOSP Keyboard, an [Apache 2.0](LICENSE-Apache-2.0) license file is provided.
100-
The icon is licensed under [Creative Commons BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/). A [license file](LICENSE-CC-BY-SA-4.0) is also included.
69+
---
10170

102-
# Credits
103-
- Icon by [Fabian OvrWrt](https://github.com/FabianOvrWrt) with contributions from [The Eclectic Dyslexic](https://github.com/the-eclectic-dyslexic)
104-
- [OpenBoard](https://github.com/openboard-team/openboard)
105-
- [AOSP Keyboard](https://android.googlesource.com/platform/packages/inputmethods/LatinIME/)
106-
- [LineageOS](https://review.lineageos.org/admin/repos/LineageOS/android_packages_inputmethods_LatinIME)
107-
- [Simple Keyboard](https://github.com/rkkr/simple-keyboard)
108-
- [Indic Keyboard](https://gitlab.com/indicproject/indic-keyboard)
109-
- [FlorisBoard](https://github.com/florisboard/florisboard/)
110-
- Our [contributors](https://github.com/Helium314/HeliBoard/graphs/contributors)
71+
*HeliboardL • Privacy-focused keyboard with AI enhancements*

0 commit comments

Comments
 (0)