TextSuggest

TextSuggest is extremely fast. It does a fuzzy search of the full included English dictionary in 0.0005 seconds.

TextSuggest can provide autocomplete in any GUI app on X11.

TextSuggest can handle a range of expansions.

Simply add them to ~/.config/textsuggest/custom-words.json in a JSON format like this:

{
    "custom": "Expansion",
    "another": "Another expansion"
}

and whenever 'custom' is typed, 'Expansion' will be typed. Similarly for 'another' ('Another expansion').

Whenever you type an unknown word, it is automatically added to your custom words file.

Inserts the output of a command:

$ls -l

when typed into a TextSuggest window, will insert output of ls -l as if it was run in a shell.

Custom words + Commands

Add in ~/.config/textsuggest/custom-words.json:

"custom": "$ command --opts"

and whenever you type 'custom' into TextSuggest, the output of command --opts will be inserted.

Simply type into TextSuggest:

= 2 + 3

And '5' will be inserted. You can do any math expression that Python supports.

You can also use any function in the Python math library, for example = sqrt(25) for √25.

Add in ~/.config/textsuggest/custom-words.json:

"custom": "= 2 + 3"

And whenever you type 'custom' into TextSuggest, 5 will be inserted.

TextSuggest supports very fast and intuitive fuzzy matching, so that you don't have to type the entire word, only portions. For example, as the screenshot at the top shows, `inting` shows suggestions for `interesting`, `painting` and so on, in order of best match.

TextSuggest supports powerful *processors* for extensions. A processor processes text before handing it over to TextSuggest to type it out. By default TextSuggest has two processors, command and math_expression (see the above Text Expansions section).

Making your own extension

A processor is a simple script/executable (any language), that must respond to matches {text} and process {text} as command line arguments.

Look into this example, written in Python (you can use any language, as long as it is an executable):

import sys
if sys.argv[1] == "matches":
    # Exit (sys.exit()) with 0 (yes) or 1 (no): whether this processor should process 'text' or not.
    # For example, the command processor has it like this:
    #     if text.startswith('$'):
    #         sys.exit(0)  # should process
    #     else:
    #         sys.exit(1)  # should not process<p></p>
if sys.argv[1] == "process":
    text = sys.argv[2]
    # Do something with 'text' and print() it.
    # This is what will be finally typed.

Make one based on the sample above, and place it in ~/.config/textsuggest/processors/.

File must be executable (chmod a+x ~/.config/textsuggest/processors/YOUR_PROCESSOR).

Processors in ~/.config/textsuggest/processors take precedence over those in /usr/share/textsuggest/processors, in case of a name or match conflict.

TextSuggest supports storing history of suggestions used. More-used suggestions will rise to the top. History can be disabled using the --no-history option. You can remove a word from history, by pressing Shift+Delete, or in the file ~/.config/textsuggest/history.json

You can tell TextSuggest to *never* show some words conveniently through - Ctrl+Shift+Delete - or in the file ~/.config/textsuggest/ignore.json

While browsing the list of suggestions, press - Alt+Enter to type it without processing. - Shift+Delete to remove it from your history. - Ctrl+Shift+Delete to add it to the ignore list (i.e. will never show up in suggestions)

Unlike many apps, TextSuggest has a fast, entirely native user interface written in Qt 5 and C++. Custom third-party UIs can also be easily made by other developers if they wish.

All languages are supported!

English dictionary are provided by default. Please search online for dictionaries of your language.

By default, only the English dictionary will be used. Use --language={your_language} option to change this.

Then TextSuggest will use {your_language}.txt file(s) in /usr/share/textsuggest/dictionaries/ (if they exist).

For example, if you want TextSuggest to use, let us say, English and Telugu dictionaries:

$ textsuggest --language=English --language=Telugu

and so on (note that --language=English,Telugu or --language English Telugu will not work, you must specify --language flag for each).

TextSuggest also has an optional feature to auto-detect your language from your keyboard layout. Use --auto-detect-language option for this.

TextSuggest can auto-detect language from following keyboard layouts:

• bd → Bangla
• us → English
• uk → English
• gb → English
• cn → Chinese
• ar → Arabic
• tw → Chinese
• de → German
• jp → Japanese
• ru → Russian
• es → Spanish
• se → Swedish
• fi → Finnish
• kr → Korean
• pk → Urdu
• fr → French
• gr → Greek
• ua → Ukrainian

Even if your language is not listed above, that only means that TextSuggest will not be able to auto-detect it from your keyboard layout! You can still specify it manually using --language={your_language} and it will work!

$ textsuggest --help
usage: textsuggest [options]
TextSuggest — universal autocomplete
optional arguments:
  -h, --help            show this help message and exit
  --word WORD [...]
                        Specify word to give suggestions for. Default: all words.
  --no-history          Disable the frequently-used words history (stored in ~/.config/textsuggest/history.json)
  --language languages [...]
                        Set language(s). Default: English. See also: --auto-detect-language.
  --auto-detect-language
                        Auto-detect language from keyboard layout.
  --selection           Show suggestions for currently selected word. See also: --auto-selection
  --auto-selection [beginning|middle|end]
                        Automatically select word under cursor and suggest. Ignored if --no-selection.
  --custom-words-only   Show custom words only.
  --no-processing       Disable using of any processors.
  -v, --version         Print version and license information.