Skip to content

Latest commit

 

History

History
96 lines (78 loc) · 5.04 KB

README_EN.md

File metadata and controls

96 lines (78 loc) · 5.04 KB
Raw

IBus Bamboo - An open source Vietnamese IME for IBus using Bamboo Engine

GitHub release License: GPL v3 contributions welcome

IBus Bamboo is a Vietnamese input method engine for IBus that translates key strokes into Vietnamese characters. For example, when you type a, an a will appear on the screen, but if one more a is typed, IBus Bamboo will replace the first a with the letter â according to Telex typing.

ibus-bamboo

Getting Started

Features

  • Support many Vietnamese character sets/encodings:
    • Unicode, TCVN (ABC)
    • VIQR, VNI, VPS, VISCII, BK HCM1, BK HCM2,…
    • Unicode UTF-8, Unicode NCR - for Web editors.
  • All popular typing methods:
    • Telex, Telex W, Telex 2, Telex + VNI + VIQR
    • VNI, VIQR, Microsoft layout
  • Using shortcut Shift+~ to switch between typing modes for an application or add it to the exclusion list:
    • Pre-edit (default)
    • Surrounding text, IBus ForwardKeyEvent,...
  • Other useful futures, easy to use:
    • Spelling check (using dictionary/rules)
    • Use oà, uý (instead of òa, úy)
    • Free tone making, macro,...
    • 2666 emojis from emojiOne

Installation

Ubuntu and derivatives

sudo add-apt-repository ppa:bamboo-engine/ibus-bamboo
sudo apt-get update
sudo apt-get install ibus-bamboo
ibus restart
# Make ibus-bamboo your default input method, this will remove other existing input layouts
env DCONF_PROFILE=ibus dconf write /desktop/ibus/general/preload-engines "['xkb:us::eng', 'Bamboo']" && gsettings set org.gnome.desktop.input-sources sources "[('xkb', 'us'), ('ibus', 'Bamboo')]"

Arch Linux and derivatives

ibus-bamboo is now available on the AUR. Don't forget to leave a vote for the maintainers so that one day it can be included in the official Arch repository!

NixOS

ibus-bamboo is available on the main Nixpkgs repo. Make sure your NixOS configuration must contain this code to install it.

{
 i18n.inputMethod = {
  enabled = "ibus";
  ibus.engines = with pkgs.ibus-engines; [
    bamboo
  ];
 };
}

Void Linux

ibus-bamboo is available on the main Void Linux repo. You can install it directly.

sudo xbps-install -S ibus-bamboo

Install from OpenBuildService

OpenBuildService

Usage

The difference between ibus-bamboo and other input methods is that ibus-bamboo provides different typing modes (1 underlined and 5 non-underlined typing modes - don't confuse typing mode with typing method, typing methods are telex, vni, ...).

To switch between typing modes, simply click on an input box (a box to enter text), then press the combination Shift+~, a table with the available typing modes will appear, you just need to press the corresponding number key to select.

Note:

  • An app may work well with one typing mode while not working well with another.
  • Typing modes are saved separately for each software (firefox is probably using mode 5, while libreoffice is using mode 2).
  • You can use Add to the exclusion list mode to not type Vietnamese in a certain program.
  • To type the character ~, press the combination Shift+~ twice.
  • Support for Wayland in IBus is not yet ideal. For a better typing experience, please use Xorg.

Bug reports

Before submitting a question or bug report, please ensure you have read through these common issues and see if you can resolve the problem on your own. If you still encounter issues after trying these steps, or you don't see something similar to your issue listed, please submit a bug report in the Bamboo issue tracker

License

IBus Bamboo is released under the GNU General Public License v3.0