Skip to content
This repository was archived by the owner on Dec 16, 2024. It is now read-only.

Commit 2e597bc

Browse files
committed
Update README.md
1 parent 334d174 commit 2e597bc

File tree

1 file changed

+27
-3
lines changed

1 file changed

+27
-3
lines changed

README.md

Lines changed: 27 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -46,9 +46,29 @@ You'll need to follow the manual installation process from [README](https://gith
4646
but before running `package-extension.sh` you'll have to make changes to your preferred layout
4747
(see [osk-layouts](https://github.com/nick-shmyrev/improved-osk-gnome-ext/tree/master/src/data/osk-layouts)), then continue with the installation process.
4848

49-
### Some symbols are missing...
50-
The keyboard uses unicode characters, try installing `ttf-symbola` on archlinux (AUR)
51-
or `ttf-ancient-fonts-symbola` on ubuntu/debian
49+
### I want to test this extension with a new version of Gnome.
50+
To install the extension on an unsupported Gnome version, you can either add desired version number to `metadata.json` file and proceed with a manual installation,
51+
or disable extension version check and then install from [extensions.gnome.org](https://extensions.gnome.org/extension/4413/improved-osk/):
52+
53+
```console
54+
gsettings set org.gnome.shell disable-extension-version-validation true
55+
```
56+
57+
Here are some of the test cases:
58+
- OSK shows up when you click/tap text inputs and/or terminal window
59+
- OSK can type lowercase chars
60+
- Tapping "Shift" switches OSK to uppercase layer
61+
- OSK can type uppercase chars
62+
- After typing an uppercase char, OSK switches back to lowercase layer
63+
- Once switched to Numbers layer, it stays latched until user switches to another layer
64+
- Long-pressing characters like "1" shows a popup with additional chars, typing those chars works
65+
- Tapping "Ctrl", "Alt", "Shift" adds highlight to those buttons
66+
- "Ctrl" and/or "Alt" remain latched when "Shift" is toggled on/off
67+
- Key combinations like "Ctrl + C", "Ctrl + X", "Ctrl + V", "Ctrl + A", "Ctrl + Z", "Ctrl + Shift + Z", "Ctrl + Shift + V" (in terminal), "Alt + Tab" work as expected
68+
- Esc, F1-12 keys work as expected
69+
- OSK works in Gnome password modal
70+
- OSK works on lock-screen
71+
- OSK settings for landscape/portrait height work
5272

5373
### Do I need to enable the OSK in Gnome accessibility settings?
5474
By default, the keyboard will pop up on touch input events.
@@ -58,3 +78,7 @@ to force the OSK to appear on non-touch events.
5878
### Extension is installed and activated, but keyboard layout doesn't change.
5979
Gnome's default on-screen keyboard, on which this extension is based on,
6080
uses `ibus` package, make sure you have it installed.
81+
82+
### Some symbols are missing...
83+
The keyboard uses unicode characters, try installing `ttf-symbola` on archlinux (AUR)
84+
or `ttf-ancient-fonts-symbola` on ubuntu/debian

0 commit comments

Comments
 (0)