Easy shift / ctrl / AltGr ... hack on xf86-input-evdev

[teika]

Hi. This hack provides for example "space/shift dual role key". When you press the space key alone, it's a space; but when you press it with another key, it's a shift. Any pairs of keys are possible. This means your hands stay almost always at their home postion. Now I can't type comfortably without it.

It's a fork of Xorg "evdev" driver (= xf86-input-evdev, or in debian xserver-xorg-input-evdev).

* Readme tells the detail.
* homepage. You can get the source tarball and git access instruction.

News for 2.7.3 (Nov 2012)
Merges the upstream 2.7.3, and has no changes in ahm itself since 2.7.1. For full changes, read README, "News" section:

Installation
I'm not a debian user, and I don't provied 2.7.3 support. The following instruction for 2.6.4 may help. Or, read the post below by Yuri Khan.

This instruction is rudimentary, so help yourself. It's for squeeze, xserver-xorg-input-evdev 1:2.3.2-6.

The strategy is: Rip the source package debian/ directory from the squeeze version, fix it, and apply to my source.

1. Download the source tarball, and a patch for debian/{rules,changelog} (I think the patch will work, but not tested yet.) All past versions are here.

There's also the patch against the Xorg's original 2.7.3 code to generate the source of my fork. (To protect your PC, patches are easier to read, and thus recommendable.)

2. Do some apt-get:
$ cd somewhere-to-run-debuild
$ apt-get build-dep xserver-xorg-input-evdev
$ apt-get apt-get source xserver-xorg-input-evdev

3. Extract files, apply the patch, and build
$ tar -xf ahm-2.x.y.tar.gz
$ cd at-home-modifier
$ cp -r ../xserver-xorg-input-evdev-2.3.2/debian ./
$ patch -p1 < squeeze2ahm-2.6.<x>.patch
$ debuild
$ dpkg -i <generated deb file>

Alternative: Ubuntu PPA
There's Ubuntu PPA for this hack by Yuri Khan. (Thanks!) I don't give general instruction and caution on PPA here. Use it at your own risk, but the source package may be nice.

Notice
When you upgrade the xorg-server, you have to rebuild this hack, too, or your keyboards and mice won't work! More precisely, for xorg-server-x.y.z, a change in z doesn't affect, but x or y does. (In debian, it seems to be called xserver-xorg-core-2:x.y.z-rel.)

Bug of the current debian patch:
* README.orig is not installed

If you know how it can be automated with git-buildpackage, please tell me.

Alternatives
* C++ implementation Space2Ctrl. See comparison with at-home-modifier.
* C implementation keydouble forked from Space2Ctrl. You may find the news at the Arch forum thread.

Notice
Probably I don't develop any more this hack as a fork of xf86-input-evdev. It's better to do all in user space, rather than as an X driver.

If you want some progress, improve Keydouble or so. I'm also interested in a rewrite in Python, which will be easier to allow flexible configuration. (In reality I don't think I'll ever write one.) It'll be great if it's integrated to AutoKey, but the AutoKey developer is not interested.

To make these hacks more popular, you can upvote my answer here to a question on Emacs Pinky in StackOverflow.

Any comments, both positive and negative, are more than welcome. Please give me a feedback. I don't know how many have tried. :/

With best regards.

[teika]

Hi. at-home-modifier-2.6.3 is released. Changes since the last post (2.6.0) are:

* Fast type fix
Users of this hack often have “tongue-twister of finger”: Suppose you want “ x”. If you press space/shift, press x, and release space/shift (before releasing x), you’ll get an upper-case X instead.
Fixes of this kind are attempted with new “AhmDelay” and “AhmFreezeTT” options.

* Cancellation by timeout
Suppose you were about to input shift + A and pressed space/shift, but you changed your mind. If you release the space/shift key, you’ll receive one space, but it’s not what you want!
This can be fixed by long enough press now.

* Reset
When something is wrong, leave the keyboard untouched for 10 secs. Then all are reset to the initial state.

* Gtk widget double press issue.
To push a gtk button, sometimes you had to press space/shift key twice, but this is fixed. If it doesn’t work out-of-box, set “AhmPaddingInterval” option. (This “bug” is not the author’s fault, but what’s bad for users are bugs.=)

For full changes, read README, "News" section:
http://gitorious.org/at-home-modifier/a ... ter/README

With best regards.

Homepage: http://gitorious.org/at-home-modifier/pages/Home

[teika]

Hi there. I've added installation instruction for squeeze. See the first post.

[teika]

You could help yourself:

* Reset
[...]all are reset to the initial state.

More is already available:

For full changes, read README[...]

From README:

*** Reset ***
Sometimes transmods get frozen (See "Switching VT" section below)
[...] Reset is implemented by sending release events to all translated
modifiers
[...]
* Switching VT: If your Ctrl is a transmod key, when you switch from X
to virtual console with Ctrl + Alt + F1, and switch back to X with Alt
+ F1, Ctrl get frozen. This is mitigated with "reset" feature.

It happens because Ctrl is pressed at the first switching, but the
release is only sent to the VT, not to X, in particular to this driver.

Now I reveal you a secret: when a developer introduces a new feature, there's a reason to do so, and when they release, they are satisfied, at least fairly.

In fact, I improved README a bit after your question. =)

Thank you for your interest. Cheers.

# BTW I've noticed that you can buy Japanese keyboards from say amazon.com. This hack works better with Japanese keyboards (read README), so when you need a new keyboard, consider buying one.

[teika]

Hi. at-home-modifier-2.6.4 is released. It has one minor fix, "mouse support":
When you press space/shift and a mouse button, the result used to be shift + click, ok, but also followed by an extra, unwanted space, as if the click hadn't happened. It's because each device ignored others. Now it's fixed, as long as the mouse is also handled by evdev driver. (Notebook touchpads are dealt by synaptics driver, so it's not fixed, and won't be fixed. Use AhmTimeout option as a workaround.)

For building, read the first message in the thread.

If you find the news or README difficult to understand, then feel free to ask.
<quote>"What's inconvenient is a bug." - Teika kazura</unquote>

[teika]

I forgot to tell you that when you upgrade the xorg-server, you have to rebuild this hack, too, or your keyboards and mice won't work! More precisely, for xorg-server-x.y.z, a change in z doesn't affect, but x or y does. (In debian, it seems to be called xserver-xorg-core-2:x.y.z-rel.)

[teika]

Hi. Ubuntu PPA for this hack is contributed by Yuri Khan. (Thanks!) I don't give general instruction and caution on PPA here. Use it at your own risk, but the source package may be nice; at least looking into debian/ directory will help.

[Yuri Khan]

Oh, I don’t think my package will be of use for Debian users, ‘cause I started with an Ubuntu package that takes the original evdev tarball and applies Ubuntu-specific patches over it. But I can detail here what I did in case someone wants to do the same for Debian (does Debian have an equivalent of Ubuntu PPA?):

• $ apt-get source xserver-xorg-input-evdev
• $ cd xserver-xorg-input-evdev-2.6.0
• $ debian/rules patch
• $ quilt new 201-at_home_modifier.patch
• $ quilt add README README.orig src/evdev.c src/evdev.h
• manually apply the patch from http://gitorious.org/at-home-modifier/d ... ster/patch (because, with an Ubuntu-specific 100-xi2.1.patch applied, ahm’s patch applies incorrectly; on Debian, your mileage may vary)
• $ quilt refresh
• $ debian/rules unpatch
• $ dch -i
• update and save the changelog
• $ debuild -S -sd
• upload the newly built source package to PPA

[teika]

I've found an alternative, Space2Ctrl, by Victor Moreira.

* s2c works in the user space, while ahm (=at-home-modifier) is the fork of an X input driver.
* s2c uses "X Record Extension" to detect events. I haven't given a try yet, but it probably stands between the X server and clients (or Xlib).
*** This (probably) means it can't coexist with other softwares which use Record Extension, e.g. AutoKey or xnee.
* s2c doesn't require much updates; ahm has to keep up with the upstream (= X).
* s2c is written in C++. (I don't understand C++. )
* The s2c code is slim; it's easier for users to hack.
*** Ahm is a fork, so the distinction of the genuine ahm part and the original X code is not clear.
* s2c is rudimentary. The sole keycode pair is hard-coded, and has no option. According to the author (in private correspondence), "more of a personal hack, very poorly tested and documented."

Read the git commit log to know the author's email address. He said he'd like more users, so sending patches may be welcome.

News: Ahm development hasn't seen any progress after the 2.6.4 release.

Thank you very much, Yuri Khan for the detailed explanation.

[teika]

An implementation in C, "keydouble" is developed by "baskerville" aka "bloom" in the ArchLinux forum. See the web site hosted at github. You may find the news at the Arch forum thread.

[teika]

Hi, folks. Not a news of ahm update, but of a good keyboard.

keyboard glossary:
https://en.wikipedia.org/wiki/Keyboard_technology
http://www.overclock.net/t/491752/mecha ... oard-guide

I recommend Japanese keyboards for at-home-modifier, because you can press many keys with thumbs. Image here:
https://en.wikipedia.org/wiki/File:KB_Japanese.svg

The bottom row of my keyboard is:
Esc-BS-Spc-Ret-Tab and
Alt-Shift-Ctrl-Shift-Alt
(The middle one is the space bar.) as described in the README of ahm. Japanese keyboards enable such stunt which is really comfy.

I use a membrane keyboard, whose touch is bad for your finger. There hasn't been good keyboards with enough many thumb keys.

Recently a new keyboard with "cherry mx brown switch", OWL-KB109BM(B)IIB, came out:
http://www.owltech.co.jp/products/keybo ... _B_II.html (Japanese)
You can buy one from amozon.co.jp, at 8000 yen or so (roughly equal to $100; these days yen is high.). They offer an English interface, too. I dislike google/apple/amazon monopoly, though. (Who likes?)
There's also "cherry mx blue" one, OWL-KB109BM(B)II, too. They say blue is noisy.

There's already many other cherry switch or capacitive switch Japanese keyboards, but they have a long space bar, which doesn't suit my purpose.

I haven't bought yet. Not cheap, but interesting. Night night.

[teika]

At-home-modifier-2.7.1 is released. (Called whimsically 2.7.1, not 2.7.0.) It merges the upstream 2.7.0, but has no changes in ahm since 2.6.4.

The Xorg's 2.7.0 has mulitouch support. If you want it, you need Xorg server >= 1.11.99.901 and "mtdev" library.

Modifications from the upstream 2.7.0 are:
* An upstream bugfix of horizontal scroll, X.Org Bug 46205, is included. (The fix is published after the 2.7.0 release.)
* Added an option to configure script "--without-mtdev". The upstream code always checks mtdev, and enables it when found. If you don't pass the above option, it falls back to the original behavior.

Read README for the details.

* Source tarball
* Patch against Xorg's original 2.7.0

I don't write Debian support for 2.7.1.

Notice
Probably I don't develop any more this hack as a fork of xf86-input-evdev. It's better to do all in user space, not as an X driver. (And personally I'm terribly weakened.)

If you want some progress, improve "Keydouble" or so. I'm also interested in a rewrite in Python, which will be easier to allow flexible configuration. (In reality I don't think I'll ever write one.) It'll be great if it's integrated to AutoKey, but the AutoKey developer is not interested.

To make these hacks more popular, you can upvote my answer here to a question on Emacs Pinky in StackOverflow.

Regards.

[debil]

Notice
Probably I don't develop any more this hack as a fork of xf86-input-evdev. It's better to do all in user space, not as an X driver. (And personally I'm terribly weakened.)

I agree, if this (ahm) was a user space app, I would've tested it (haven't been in the mood for compiling X). Anyway, cheers for the contribution, us heavy keyboard users appreciate greatly.

[teika]

Hi. At-home-modifier-2.7.3 is released. It merges the upstream 2.7.3, but has no changes in ahm itself since the last release, 2.7.1.

Sources:
* The full source tarball
* The patch against Xorg's original 2.7.3

I don't write Debian support for 2.7.3. Please share yours.

Regards.