A virtual keyboard for the awesome window manager
Go to file
XeonSquared 2a5debe903 fix ambiguous syntax error on Lua 5.1 2022-08-27 17:54:11 +10:00
keymaps update misc 2022-08-25 13:58:39 +10:00
LICENSE Add implementation, add a keymap, prettify the license, add instructions 2021-11-20 15:16:05 +01:00
README.md update misc 2022-08-25 13:58:39 +10:00
init.lua fix ambiguous syntax error on Lua 5.1 2022-08-27 17:54:11 +10:00

README.md

vkbd - A virtual keyboard for the awesome window manager

Limitations

Right now, only two US (us, ansi) and a German (de) keymap are supported. However, extending with custom keymaps is simple. Tip: Use xev to find out the necessary keycodes.

Keycodes may differ, depending on the selected X keymap. Make sure that the selected X keymap matches the virtual keyboard's map.

Installation

cd ~/.config/awesome/
git clone https://codeberg.org/fangchar/vkbd vkbd

Usage

local vkbd = require("vkbd")
vkbd.init('de')

-- Now you can add it to a wibar
awful.screen.connect_for_each_screen(function(s)

  s.keyboard = awful.wibar({
    height = 300,
    position = "bottom",
    screen = s
  })

  s.keyboard:setup ({
    layout = wibox.layout.ratio.horizontal,
    vkbd
  })

end)

License

All code is licensed under the terms of the ISC license.