Modded svkbd to be optimized for the day-to-day mobile user and power user
This repository has been archived on 2024-08-20. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Alex D. a8ea266a79
Shorten key names
2020-12-06 00:14:18 +00:00
LICENSE Added Xft support (in the same fashion as done in dmenu by Hiltjo Posthuma), Xinerama support, changed colors and key layout 2020-08-02 18:00:00 +02:00
Makefile Make install fix: install the actual compiled layout 2020-09-16 23:31:37 +02:00
README.md Made the old layouts compatible with the new svkbd, re-added the old english layout that was removed, and re-added the initial sxmo layout and renamed the mobile layouts. Documentation updated accordingly. Final cleanup and fixes for the whole patch series. 2020-08-02 18:00:42 +02:00
config.def.h Added a dialer/numpad keyboard, added the ability to handle layouts with less keys/different layouts. Extra configurability: select layout on startup, customisable height factor. 2020-08-02 18:00:35 +02:00
config.mk config.mk: set DEFAULT_SOURCE 2020-09-18 12:59:17 +02:00
drw.c tiny code-style tweak 2020-08-24 19:32:47 +02:00
drw.h tiny code-style tweak 2020-08-24 19:32:47 +02:00
layout.mobile-intl.h Shorten key names 2020-12-06 00:14:18 +00:00
svkbd.1 svkbd.1: small man page tweaks 2020-08-04 23:14:38 +02:00
svkbd.c a few more tweaks 2020-08-05 00:09:41 +02:00
util.c some code-style consistency changes + small tweaks 2020-08-04 23:52:57 +02:00
util.h Added Xft support (in the same fashion as done in dmenu by Hiltjo Posthuma), Xinerama support, changed colors and key layout 2020-08-02 18:00:00 +02:00

README.md

SVKBD: Simple Virtual Keyboard

This is a simple virtual keyboard, intended to be used in environments, where no keyboard is available.

Installation

$ make
$ make install

This will create by default svkbd-intl, which is svkbd using an international layout with multiple layers and overlays, and optimised for mobile devices.

You can create svkbd for additional layouts by doing:

$ make LAYOUT=$layout

This will take the file layout.$layout.h and create svkbd-$layout. make install will then pick up the new file and install it accordingly.

Layouts

The following layouts are available:

  • Mobile Layouts:
    • mobile-intl - A small international layout optimised for mobile devices. This layout consists of multiple layers which can be switched on the fly, and overlays that appear on long-press of certain keys, adding input ability for diacritics and other variants, as well as some emoji. The layers are:
      • a basic qwerty layer
      • a layer for numeric input, arrows, and punctuation
      • a layer for function keys, media keys, and arrows
      • a cyrillic layer (ЙЦУКЕН)
      • a dialer/numeric layer
    • mobile-plain - This is a plain layout with only a qwerty layer and numeric/punctuation layer. It was originally made for sxmo.
  • Traditional layouts:
    • en - An english layout without layers (QWERTY)
    • de - A german layout (QWERTZ)
    • ru - A russian layout (ЙЦУКЕН)
    • sh - A serbo-croatian layout using latin script (QWERTZ)

Usage

$ svkbd-mobile-intl

This will open svkbd at the bottom of the screen, showing the default international layout.

$ svkbd-mobile-intl -d

This tells svkbd to announce itself being a dock window, which then is managed differently between different window managers. If using dwm and the dock patch, then this will make svkbd being managed by dwm and some space of the screen being reserved for it.

$ svkbd-mobile-intl -g 400x200+1+1

This will start svkbd-intl with a size of 400x200 and at the upper left window corner.

For layouts that consist of multiple layers, you can enable layers on program start through either the -l flag or through the SVKBD_LAYERS environment variable. They both take a comma separated list of layer names (as defined in your layout.*.h). Use the button in the bottom-left to cycle through all the layers.

Some layouts come with overlays that will show when certain keys are hold pressed for a longer time. For example, a long press on the a key will enable an overview showing all kinds of diacritic combinations for a.

Overlay functionality interferes with the ability to hold a key and have it outputted repeatedly. You can disable overlay functionality with the -O flag or by setting the environment variable SVKBD_ENABLEOVERLAYS=0. There is also a key on the function layer of the keyboard itself to enable/disable this behaviour on the fly. Its label shows when the overlay functionality is enabled and when not.

Notes

This virtual keyboard does not actually modify the X keyboard layout, the mobile-intl, mobile-plain and en layouts simply rely on a standard US QWERTY layout (setxkbmap us) being activated, the other layouts (de, ru, sh) require their respective XKB keymaps to be active.

If you use another XKB layout you will get unpredictable output that does not match the labels on the virtual keycaps!

Repository

git clone https://git.suckless.org/svkbd