spiegel-keyman/linux/help/common/index.md
Eberhard Beilharz 8f4a4b3e6c
docs(linux): Update common questions
- add Ubuntu 18.04 as being last supported in Keyman 16
- clarify that km-config needs to be started from command line
  in order to disable error reporting
2023-03-28 09:22:33 +02:00

84 lines
2.8 KiB
Markdown

---
title: Common Questions
---
## Q. How do I install Keyman for Linux?
**A.** In Ubuntu and Wasta-Linux, Keyman for Linux can be installed via launchpad:
```bash
sudo add-apt-repository ppa:keymanapp/keyman
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install keyman onboard-keyman
```
An older version of Keyman for Linux packages is also available in any current Debian at:
[https://packages.debian.org/keyman](https://packages.debian.org/keyman)
## Q. How do I install a Keyman keyboard?
**A.** Follow this [guide](../start/installing-keyboard) for installing Keyman keyboards.
## Q. What's the relationship between Keyman for Linux and KMFL?
**A.** KMFL is no longer actively developed, although it can still be installed.
Both Keyman for Linux and KMFL are available in the Keyman
[PPA](https://en.wikipedia.org/wiki/Ubuntu#Package_Archives). The installation
instructions above will install Keyman, not KMFL. KMFL was developed as a black-box clone of Keyman
for Windows years ago; after Keyman was released as open source it became possible to share the
code base between Windows and Linux. Keyman for Linux is the long-term supported solution.
## Q. Can I have Keyman for Linux and KMFL installed at the same time?
**A.** Yes. To install KMFL on Ubuntu:
```bash
sudo add-apt-repository ppa:keymanapp/keyman
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install ibus-kmfl
```
## Q. If I already had KMFL installed, how can I uninstall KMFL before installing Keyman?
**A.** It is good to remove any keyboards from ibus e.g. KMFL keyboards before you remove KMFL.
Then, to remove KMFL:
```bash
sudo dpkg --purge ibus-kmfl libkmfl
```
## Q. How do I display the On-screen Keyboard (OSK)?
**A.** From the launcher, enter `onboard`
![](../linux_images/onboard.png "Onboard")
## Q. What Linux distros will Keyman work with?
**A.** Keyman runs on Debian, Ubuntu, Wasta Linux and can be compiled to run
from source in most distributions.
**Note:** Keyman for Linux no longer supports Ubuntu 16.04 LTS (Xenial Xerus).
Keyman 16 was the last version that supports Ubuntu 18.04 LTS (Bionic Beaver).
## Q. Will my existing Windows Keyman keyboard work with Keyman for Linux?
**A.** Most keyboards will work without change. A small subset of keyboards
require features which are not yet available in Keyman for Linux. These
features will be progressively implemented.
## Q. How can I disable automatically reporting errors?
**A.** If Keyman crashes, it will automatically send a report to the development
team. This report is anonymous and contains only technical details relating to
the crash. It does not include keystroke data or personally identifying data. If
you don't want these automatic error reports to be sent you can set the
environment variable `KEYMAN_NOSENTRY` and start `km-config` from
the command line:
```bash
export KEYMAN_NOSENTRY=1
km-config
```