Simple utility to turn swipes into words -- "plugin" for wvkbd to enable swipe-typing under wayland SXMO.
Diffstat (limited to 'README.md')
-rw-r--r--README.md35
1 files changed, 34 insertions, 1 deletions
diff --git a/README.md b/README.md
index 5ed1631..1137291 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,7 @@ swipeGuess also provides options for returning multiple results and ignoring cer
The input program should output a stream of letters "swiped through", then a newline.
-This is supported by [wvkbd](https://github.com/proycon/wvkbd) since version 0.6.
+This is supported by [wvkbd](https://github.com/proycon/wvkbd) since version 0.6 and [phosh-osk-stub](https://gitlab.gnome.org/guidog/phosh-osk-stub) since 0.28.0.
## wordlist
@@ -64,6 +64,39 @@ If your keys are in a hexagonal layout, use mapScore like
3. `wvkbd-mobintl -O | swipeGuess /path/to/words.txt | completelyTypeWord.sh`
* In SXMO, `KEYBOARD_ARGS='-O | swipeGuess /path/to/words.txt | completelyTypeWord.sh'` can be added to your ~/.profile to enable this (effective on restart).
+# Usage with phosh-osk-stub
+
+```
+gsettings set sm.puri.phosh.osk osk-features "['key-drag']"
+gsettings set sm.puri.phosh.osk.Completers.Pipe command 'swipeGuess /usr/share/swipeGuess/words/words-qwerty-en 5 | tr "\t" "\n"'
+gsettings set sm.puri.phosh.osk.Completers default pipe
+gsettings set sm.puri.phosh.osk completion-mode "['manual','hint']"
+```
+
+## Multiple suggestions
+
+phosh-osk-stub's pipe completer accepts multiple suggestions, newline separated. This can be scripted like
+
+```
+gsettings set sm.puri.phosh.osk.Completers.Pipe command 'sh -c "swipeGuess /usr/share/swipeGuess/words/words-qwerty-en 5 | tr \"\t\" \"\n\""'
+```
+
# Extended information
[SwipeBehaviors](https://git.sr.ht/~earboxer/SwipeBehaviors) is a project that uses swipeGuess and provides more advanced functionality, like presenting several choices that can be picked with [suggpicker](https://git.sr.ht/~earboxer/suggpicker).
+
+# Contributing
+
+swipeGuess is maintained by [Zach DeCook](https://zachdecook.com/), who may or may not be reached directly for related inquiries.
+
+Patches and long-form discussions for this project are also accepted on my swipeKeyboard mailing list on sourcehut: ([email](mailto:~earboxer/swipeKeyboard@lists.sr.ht)/[archive](https://lists.sr.ht/~earboxer/swipeKeyboard)).
+
+e.g.
+
+```
+git config sendemail.to '~earboxer/swipeKeyboard@lists.sr.ht'
+git config format.subjectPrefix 'PATCH swipeGuess'
+git send-email HEAD~1
+```
+
+(See `man git-send-email` or https://git-send-email.io for more information)