doc/packages/ibus.section.md

   1 # ibus-engines.typing-booster {#sec-ibus-typing-booster}
   2
   3 This package is an ibus-based completion method to speed up typing.
   4
   5 ## Activating the engine {#sec-ibus-typing-booster-activate}
   6
   7 IBus needs to be configured accordingly to activate `typing-booster`. The configuration depends on the desktop manager in use. For detailed instructions, please refer to the [upstream docs](https://mike-fabian.github.io/ibus-typing-booster/).
   8
   9 On NixOS, you need to explicitly enable `ibus` with given engines before customizing your desktop to use `typing-booster`. This can be achieved using the `ibus` module:
  10
  11 ```nix
  12 { pkgs, ... }: {
  13   i18n.inputMethod = {
  14     enable = true;
  15     type = "ibus";
  16     ibus.engines = with pkgs.ibus-engines; [ typing-booster ];
  17   };
  18 }
  19 ```
  20
  21 ## Using custom hunspell dictionaries {#sec-ibus-typing-booster-customize-hunspell}
  22
  23 The IBus engine is based on `hunspell` to support completion in many languages. By default, the dictionaries `de-de`, `en-us`, `fr-moderne` `es-es`, `it-it`, `sv-se` and `sv-fi` are in use. To add another dictionary, the package can be overridden like this:
  24
  25 ```nix
  26 ibus-engines.typing-booster.override { langs = [ "de-at" "en-gb" ]; }
  27 ```
  28
  29 _Note: each language passed to `langs` must be an attribute name in `pkgs.hunspellDicts`._
  30
  31 ## Built-in emoji picker {#sec-ibus-typing-booster-emoji-picker}
  32
  33 The `ibus-engines.typing-booster` package contains a program named `emoji-picker`. To display all emojis correctly, a special font such as `noto-fonts-color-emoji` is needed:
  34
  35 On NixOS, it can be installed using the following expression:
  36
  37 ```nix
  38 { pkgs, ... }: {
  39   fonts.packages = with pkgs; [ noto-fonts-color-emoji ];
  40 }
  41 ```