(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
Tapper is a keyboard layout switcher for X Window System and Wayland. Tapper runs in background, when an assigned key is tapped, Tapper activates the corresponding keyboard layout. Tapper key feature is using modifier keys for switching keyboard layouts without losing modifier’s functionality. Tapper works for GNOME, GNOME Classic, Cinnamon, i3, KDE, LXDE, LXQt, Mate, Ubuntu, Xfce desktops.
A <em>tap</em> means that a single key is pressed and quickly released, so: (1) no other keys are pressed or released at this time, and (2) period between pressing the key and releasing it is shorter than keyboard repeat delay (the amount of time you have to hold down a key before it starts repeating; usually 0.5 second, but it depends on your desktop settings).︎
Таппер — включалка раскладок клавиатуры для Иксов и Вайланда. Таппер работает в фоновом режиме, и при ударе по назначенной клавише Таппер включает соответствующую ей раскладку клавиатуры. Особенность Таппера заключается в использовании клавиш-модификаторов для включения раскладок без потери функций модификаторов. Таппер работает в Гноме, Классическом Гноме, и3, КДЕ, ЛХДЕ, ЛХКт, Мате, Хфце, Циннамоне.
<em>Удар</em> — нажатие и быстрое отпускание одной клавиши, при этом: (1) во время удара никакие другие клавиши не нажаты, не нажимаются и не отпускаются, и (2) период между нажатием и отпусканием короче задержки автоповтора (обычно автоповтор включается если клавиша удерживается более половины секунды; это зависит от настроек рабочего стола).
«Удар» по-английски — <em>tap</em>. Отсюда происходит название программы.
The GNOME layouter monitors the GNOME session. If the session becomes inactive (e. g. when the user switches to the GNOME Display Manager screen or to another session), Tapper switches to the passive mode: it continues to listen user input events, but does not execute any actions (does not activate layouts and does not emulate keystrokes). If the session becomes active, Tapper switches back to normal mode. This prevents unwanted interference between sessions.
Tapper was unable to detect Ubuntu desktop running on top of a Wayland session. Thanks to Михаил Желудков for reporting the problem. Now Tapper in such case (if <code>XDG_SESSION_DESKTOP</code> is <code>ubuntu-wayland</code>) selects the GNOME layouter.
If the <code>--show-taps</code> option specified, Tapper shows taps, but ignores all the assignments (i. e. does not execute any actions: does not activate keyboard layouts and does not emulate keystrokes).
Man page is available in [Russian language][man.ru].
The <code>setup.sh</code> script works for Void Linux (glibc is required, building with musl will fail).
Bug fix: Russian home page contained incorrect installation instruction for openSUSE. Thanks to KOT040188 for reporting.
Tapper privileges are cut down: Tapper does not need full <code>root</code> power, two capabilities <code>cap_setuid</code> and <code>cap_setgid</code> are enough. Instead of <code>chmod u+s</code> the installer performs <code>setcap cap_setuid,cap_setgid=p</code>. Tapper drops all capabilities in the very beginning.
License for small supporting files changed to FSFAP.
Metainfo file is added.
The <code>setup.sh</code> script works for AltLinux (<code>configure && make</code> works in AltLinux, but building an RPM package from the provided spec file does not).
<em>Highlight:</em> The KDE layouter is added, it works for both X Window System and Wayland. There is a minor drawback, though: the KDE layouter cannot ring the bell.
<em>Breaking change:</em> Because of the KDE layouter addition, GSettings schema is changed. Check the layouter selection setting after updating Tapper.
Error reporting is improved in case if no suitable listener/layouter/emitter is found.
If layouter is not explicitly selected and the <code>XDG_SESSION_DESKTOP</code> environment variable is <code>gnome-xorg</code>, Tapper uses the GNOME layouter.
<code>BUGS.md</code> documents what information must be included into a bug report.
Tapper desktop support matrix is added to the Tapper home page.
Tapper RPM requires Agism RPM only if <code>gnome-shell</code> package is already installed. Also Tapper RPM recommends <code>dconf-editor</code> RPM.
Bug fix: Syntax of action key codes in settings and in the command line was inconsistent: codes in settings required a <code>#</code> prefix, while key codes in the command line did not. Now key codes are written with no prefix, as documented.
The <code>--autostart</code> and <code>--no-autostart</code> options respect the <code>--datadir</code> configuration option.
The <code>--autostart</code> and <code>--no-autostart</code> options respect the <code>XDG_CONFIG_HOME</code> environment variable.
Spaces are tolerated in actions (e. g. <code>KEY_CAPSLOCK = @1, 1</code>) in both settings and command-line arguments.
The <code>--dconf-editor</code> option is introduced to edit Tapper settings with the <code>dconf-editor</code> graphical tool.
The <code>--autostart</code> option is introduced to set up Tapper to start automatically when you log in. The <code>--no-autostart</code> option disables autostart.
The libinput listener respects the <code>XDG_SEAT</code> environment variable if it is set.
Bug fix: The GNOME layouter ringed the bell regardless of the <code>--bell</code>/<code>--no-bell</code> option and settings. Thanks to papin-aziat and Vitaly for reporting.
RHEL 8 build is fixed.
Minor changes in the documentation (HTML pages and man page).
<em>Highlight:</em> Tapper works in GNOME 41 and does not require “Unsafe Mode”.
<em>Important:</em> The GNOME layouter requires [Agism], a GNOME Shell extension, which should be installed and enabled. See “[Caveats/GNOME layouter does not work]” in [tapper(1)].
<em>Breaking change:</em> Since Tapper can’t hide input events from other programs, “interceptor” is renamed to “listener”: the <code>--interceptor</code> command line option is renamed to <code>--listener</code>, key in GSettings schema is also renamed.
<em>Highlight:</em> Tapper can emulate keystrokes. See “[Description/Actions]”, “[Description/Assignments]” and “[Examples/Advanced usage]” in [tapper(1)].
<em>Breaking change:</em> Because of ability to emulate keystrokes, the assignment syntax is changed. Keyboard layouts must be prefixed with <code>@</code> in order to distinguish between keyboard layouts and keys. Both command line and GSettings schema are affected.
Tapper drops unnecessary privileges as soon as possible. See “[Description/Security note]” in [tapper(1)].
Build: libjson-glib is not required any more. libevdev is required.
Build: <code>setup.sh</code> script are added to install required packages, it works for Arch, Debian, Fedora, Mageia, openSUSE, and Ubuntu.
<em>Highlight:</em> Tapper is tested in bunch of desktops: Cinnamon, GNOME Classic, KDE, LXDE, LXQt, Mate, Xfce. Tappers works perfectly in all these desktops, so “GNOME Shell” is dropped from Tapper headline. Now it is “a keyboard layout switcher for X Window System and Wayland”. GNOME Shell is still a primary target for Tapper though.
Bug fix: Command line assignments didn’t override settings assignments.
GNOME detection is changed: The <code>XDG_CURRENT_DESKTOP</code> environment variable is retired, the <code>XDG_SESSION_DESKTOP</code> is analyzed instead.
Desktop file is updated so Tapper is always shown (not just in GNOME, as before).
Tapper home page is updated with getting instructions for Arch, Mageia and openSUSE.
The <code>--no-default-assignments</code> command line option is introduced. It is used for testing purposes and has little value for users.
Few corner cases are handled more gracefully:
<code>INSTALL.md</code> now includes build instructions for Mageia and openSUSE.
Build: <code>configure</code> options <code>--enable-libinput</code> and <code>--enable-x</code> are renamed to <code>--with-libinput</code> and <code>--with-x</code> respectively to follow Autoconf guidelines.
Build: New configure options <code>--with-glib</code> and <code>--without-glib</code> are introduced to decouple GLib usage from GNOME support. Now it is possible to disable GNOME layouter but still use GSettings to store configuration.
Build: The <code>--enable-author-testing</code> configure option is introduced. If author testing is disabled, some non-functional tests (e. g. cppcheck, spell check) are not run because there is no point in running these tests for packagers and end users.
Tests are reworked:
The <code>--syslog</code> command line option is introduced.
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)
(null)