DeforaOS/Keyboard
DeforaOS/Keyboard
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
166 Commits 2 Branches 4 Tags 199 KiB
C 95.3%
Shell 4.7%
master
Go to file
Pierre Pronchery 05cefd5ae0 data: rename the desktop files
2024-11-29 01:06:20 +01:00
data data: rename the desktop files 2024-11-29 01:06:20 +01:00
include Update the copyright notice 2016-09-24 04:16:04 +02:00
po Import the newer scripts from DeforaOS configure 2020-11-19 03:15:40 +01:00
src Update the copyright notice 2020-01-12 07:48:38 +01:00
tools Build with Gtk+ 3 by default 2020-01-12 03:31:03 +01:00
.gitignore Also ignore shared objects 2016-03-12 02:27:59 +01:00
COPYING Re-license as 2-clause BSD 2016-09-24 04:15:43 +02:00
project.conf Also install the COPYING file 2020-02-03 05:23:51 +01:00
README.md Extend the README file 2020-01-12 07:43:14 +01:00

README.md

DeforaOS Keyboard

About Keyboard

This program emulates a physical keyboard by providing a virtual interface on screen. It currently supports four modes:

  • docked, where it will occupy the bottom of the screen;
  • popup, likewise as a popup window;
  • windowed, where it can be found in the system tray (the default)
  • embedded, which outputs its window ID for inclusion within another program.

Additionally, it can be piloted through its companion tool, desktopctl(1).

Keyboard is part of the DeforaOS Project, found at https://www.defora.org/.

Compiling Keyboard

The current requirements for compiling Keyboard are as follows:

  • Gtk+ 2.4 or later, or Gtk+ 3.0 or later
  • DeforaOS libDesktop
  • an implementation of make
  • gettext (libintl) for translations

With these installed, the following command should be enough to compile Keyboard on most systems:

$ make

The following command will then install Keyboard:

$ make install

To install (or package) Keyboard in a different location:

$ make clean
$ make PREFIX="/another/prefix" install

Keyboard also supports DESTDIR, to be installed in a staging directory; for instance:

$ make DESTDIR="/staging/directory" PREFIX="/another/prefix" install

On some systems, the Makefiles shipped can be re-generated accordingly thanks to the DeforaOS configure tool.

The compilation process supports a number of options, such as PREFIX and DESTDIR for packaging and portability, or OBJDIR for compilation outside of the source tree.

Distributing Keyboard

DeforaOS Keyboard is subject to the terms of the 2-clause BSD license. Please see the COPYING file for more information.