sigma/keycodemapdb
1
0
Fork 0
mirror of https://gitlab.com/qemu-project/keycodemapdb.git synced 2026-03-06 21:50:21 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description
89 commits 1 branch 0 tags 184 KiB
Find a file
Exact
Daniel P. Berrangé 54788039c0 Fix BSD license text project name placeholder 
It was mistakenly copied from a source which had inserted the
"PyCA Cryptography" project name, despite this project being
entirely unrelated to that.

Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
2025-07-10 15:06:01 +01:00
data data: add more mappings for NeXT keyboard 2024-11-05 14:52:03 +00:00
tests rust: fix cargo clippy 2021-03-08 01:10:33 +04:00
tools data: add more mappings for NeXT keyboard 2024-11-05 14:52:03 +00:00
.gitattributes Add .gitattributes file 2022-03-22 11:49:11 +01:00
LICENSE.BSD Fix BSD license text project name placeholder 2025-07-10 15:06:01 +01:00
LICENSE.GPL2 Update to latest GPL license text 2025-07-10 12:56:05 +01:00
meson.build make the meson.build stub a bit more well-rounded by exporting files 2022-06-21 20:20:27 -04:00
README README: mention more keycode maps that we support 2024-11-04 11:38:45 +00:00

README 

   Key code / scan code / key symbol mapping database
   ==================================================

This module provides a database that maps between different
key code / scan code / key symbol sets:

 - Linux evdev
 - OS-X
 - AT Set 1
 - AT Set 2
 - AT Set 3
 - XT
 - Linux XT KBD driver
 - USB HID
 - Win32
 - XWin XT
 - XKBD XT
 - Xorg Evdev
 - Xorg KBD
 - Xorg OS-X
 - XOrg Cygwin
 - RFB
 - HTML code
 - QEMU QKeyCode
 - Sun KBD
 - Apple ADB
 - NeXT Cube

Licensing
---------

The contents of this package are dual licensed under the terms of:

 - GNU General Public License (version 2 or later)
 - 3-clause BSD License

The output files generated by keymap-gen may be distributed & used under
the terms of either of the above licenses.

Data formats
------------

The following output formats are possible

 - Code map

   An array mapping between key code sets values

   Indexes in the array are values from the source code set.
   Entries in the array are values from the target code set


 - Code table

   An array listing all values in a key code set

   Indexes in the array are simply a numeric counter
   Entries in the array are values from the key code set

   The size of the array matches the total number of entries in
   the keycode database.


 - Name map

   An array mapping between key code sets values and names

   Indexes in the array are values from the source code set
   Entries in the array are names from the target code set


 - Name table

   An array listing all names in a key code set

   Indexes in the array are simply a numeric counter
   Entries in the array are values from the key code set

   The size of the array matches the total number of entries in
   the keycode database.


Output languages
----------------

The tool is capable of generating data tables for the following
programming languages / environments

 - Standard C
 - GLib2 (standard C, but with GLib2 data types)
 - Python
 - Perl
 - Rust


Usage
-----

Map values from AT Set 1 to USB HID, generating tables for the
C programming language

 $ keymap-gen --lang stdc code-map data/keymaps.csv atset1 usb

Generate a tables of names for Linux key codes, OS-X key codes,
in python - equivalent array indexes map between the two sets.
A variable name override is used

 $ keymap-gen --varname linux_keycodes --lang stdc \
              code-table data/keymaps.csv linux
 $ keymap-gen --varname osx_keycodes --lang stdc \
              code-table data/keymaps.csv os-x

Generate a mapping from XOrg XWin values to Win32 names

 $ keymap-gen --lang perl name-map data/keymaps.csv xorgxwin win32

Generate a table of names for Linux key codes in Perl

 $ keymap-gen --lang perl name-table data/keymaps.csv linux