1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
Maliit
======
Maliit provides a flexible and cross-platform input method framework. It has a
plugin-based client-server architecture where applications act as clients and
communicate with the Maliit server via input context plugins. The communication
link currently uses D-Bus. Maliit is an open source framework (LGPL 2.1) with
a production-quality [keyboard plugin](https://github.com/maliit/keyboard) (LGPL 3.0).
Installing
----------
Qt 5 must be installed to build the Maliit framework. At a terminal, run:
```
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr ..
make
make install
```
Running
-------
Set Maliit as the Qt and GTK+ input context:
```
export QT_IM_MODULE=Maliit
export GTK_IM_MODULE=Maliit
```
Start the server:
```
maliit-server
```
Note that a compositing window manager and a D-Bus session bus are required to
use Maliit.
Test with the provided example applications:
```
maliit-exampleapp-plainqt # for Qt
maliit-exampleapp-gtk2 # for Gtk2
maliit-exampleapp-gtk3 # for Gtk3
```
Double-tap on the input field, and an input method (usually a virtual keyboard)
should be shown. Note that an input method plugin, such as the Maliit keyboard
from the maliit-plugins package, must be installed for the example applications
to work.
NETWORK TRANSPARENCY
On one computer run:
```
maliit-server -allow-anonymous -override-address tcp:host=xxx.xxx.xxx.xxx,port=yyyyy
```
Any valid dbus address is supported. Using -allow-anonymous must only be done on
a trusted network. If using a method with authentication, the -allow-anonymous flag
may be dropped.
On another computer:
```
MALIIT_SERVER_ADDRESS=tcp:host=xxx.xxx.xxx.xxx,port=yyyyy
export MALIIT_SERVER_ADDRESS
maliit-exampleapp-plainqt (or maliit-exampleapp-gtk{2,3})
```
Where xxx.xxx.xxx.xxx is IP address of computer where maliit-server is ran
and yyyyy is port number < 65536.
|
