1ba6f518618b462bfdd0345469f75599cbe7de3a
[platform/upstream/kmscon.git] / README
1 = KMSCON =
2 Kmscon is a simple terminal emulator based on linux kernel mode setting (KMS).
3 It is an attempt to replace the in-kernel VT implementation with a userspace
4 console.
5
6 == Requirements ==
7   Kmscon requires the following software:
8     - udev
9     - mesa with:
10       - EGL library
11       - gbm library
12       - GL library
13     - pango with:
14       - glib
15       - cairo
16       - pango
17     - libxkbcommon
18
19 == Install ==
20   To compile the kmscon binary, run the standard autotools commands:
21     $ ./configure [--enable-debug]
22     $ make
23     $ make install
24   To compile the test applications, run:
25     $ make check
26
27 == License ==
28   This software is licensed under the terms of the MIT license. Please see
29   ./COPYING for further information.
30
31 == FAQ ==
32   === Why didn't you use libvte or similar terminal emulators? ===
33   All existing terminal emulators I found highly depend on X. Also, their code
34   base often is a horrible mess. I haven't had the time to convert them to use
35   other drawing functions than Xlib, yet.
36   If you feel like doing this work, please notify me. I would be glad to adjust
37   my code to work with other terminal emulators.
38
39 == Contact ==
40   This software is maintained by:
41     David Herrmann <dh.herrmann@googlemail.com>
42   If you have any questions, do not hesitate to contact one of the maintainers.
43
44 == Code Base ==
45   The kmscon code is split into several independent subsystems:
46     - output:
47       This code manages the KMS/DRI output and provides OpenGL framebuffers.
48     - console:
49       This draws the text on the screen and provides an API for any terminal
50       emulator to visualize its contents.
51     - evdev:
52       All linux input events are captured here and converted to Unicode
53       characters for input handling.
54     - vte:
55       The terminal emulator library.
56     - main:
57       This connects all subsystems into a usable console application.