pinephone-mods
/
svkbd
Archived
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
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.
63 Commits 1 Branch 0 Tags 146 KiB
C 75.1%
Objective-C 17.3%
Makefile 3.6%
Roff 3.5%
C++ 0.5%
Go to file
Maarten van Gompel 4dab556580 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
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 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 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.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 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
drw.c 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
drw.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
layout.arrows.h Adding close button. 2011-04-04 22:43:12 +02:00
layout.de.h Adding delete to the German layout. 2011-11-10 19:11:25 +01:00
layout.ru.h Adding ru and sh layout. 2013-04-28 10:24:15 +02:00
layout.sh.h Adding ru and sh layout. 2013-04-28 10:24:15 +02:00
layout.sxmo.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
svkbd.1 cleanup Makefile, add initial man page svkbd.1 2020-05-29 14:46:33 +02:00
svkbd.c 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
util.c 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
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 

SVKBD
=====

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-sxmo`, which is svkbd using an versatile
layout with multiple layers and overlays, and optimised for mobile devices.
It was designed for [Simple X Mobile](https://sr.ht/~mil/Sxmo).

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.

Usage
-----

	% svkbd-sxmo

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

	% svkbd-sxmo -d

This tells svkbd-sxmo 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-sxmo -g 400x200+1+1

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

You can enable layers on the fly 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.

The virtual keyboard comes 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, it simply relies on a standard US QWERTY layout
(setxkbmap us) being activated. If you use another XKB layout you will get unpredictable output that does not match the
labels on the virtual keycaps.

Repository
----------

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