librelist archives

« back to archive

Custom TMK keymap

Custom TMK keymap

From:
Tom Short
Date:
2015-06-06 @ 02:06
Hi everyone,

I've been using and enjoying my Atreus for a couple of weeks now. Here is
my custom TMK keymap:

  -

https://github.com/tshort/tmk_keyboard/blob/keymap-ts/keyboard/atreus/keymap-ts.pdf

Here is the main file with the keymap and the branch in my repository with
this layout:

  -

https://github.com/tshort/tmk_keyboard/blob/keymap-ts/keyboard/atreus/keymap_qwerty_ts.c

  - https://github.com/tshort/tmk_keyboard/tree/keymap-ts

TMK's advanced features work really well. With the ACTION_LAYER_* and
ACTION_MOD_* keys, you can move more functionality to the prime thumb keys.
I have two additional layers:

(*) L1 -- This is for punctuation and function keys. A thumb key activates
this layer when held and acts as backspace when tapped.

(*) L2 -- This is for a number pad and movement keys. Because many of these
keys will be pressed repeatedly, I have one thumb key on each side that can
activate this. This allows me to hold the layer key with a thumb on one
hand and press keys with the other hand. I tried making this a toggle
layer. Even though I like modal editing ala VIM, I didn't like it--I was
getting too confused as to which layer was active. I might try this again
now that I'm not making so many key-press errors.

I also use ACTION_MOD_TAP to pair TAB and ESC with modifiers to make them
more accessible. Overall, I haven't had any problems with keys with double
functionality.

-Tom

Re: [atreus] Custom TMK keymap

From:
Phil Hagelberg
Date:
2015-06-07 @ 13:43
Tom Short <tshort.rlists@gmail.com> writes:

> (*) L2 -- This is for a number pad and movement keys. Because many of these
> keys will be pressed repeatedly, I have one thumb key on each side that can
> activate this. This allows me to hold the layer key with a thumb on one
> hand and press keys with the other hand. I tried making this a toggle
> layer.

Cool! Glad you found this useful.

I've avoided recommending the use of keys that act as modifiers or
regular keys just because it's already so much mental overhead to make
the switch to the Atreus, but it's definitely a compelling feature for
advanced users. Do you think if someone didn't understand what was going
on they would be pretty confused if they activated it by accident?

I have been thinking of creating an "Advanced tips" section of the wiki;
this would be a great candidate for inclusion there; I'm sure folks can
think of other suggestions for that as well, so here it is:

  https://github.com/technomancy/atreus/wiki/Tips

While writing this I realized it would be good to create a listing of
the main layouts with descriptions, just to have them all collected in
one place:

  https://github.com/technomancy/atreus/wiki/Layouts

If anyone has suggestions for additional entries to either of these
pages please feel free to add them.

-Phil

Re: [atreus] Custom TMK keymap

From:
Tom Short
Date:
2015-06-09 @ 11:23
The dual-function keys added little extra mental overhead for me. For me,
getting used to the physical placement of the non-staggered keys was by far
the biggest hurdle. The dual-function keys were easy to get used to
(surprisingly). The only functionality that I struggled with was toggling
of layers. I stopped using that as it was too confusing.

Tom Short <tshort.rlists@gmail.com> writes:

> (*) L2 -- This is for a number pad and movement keys. Because many of
these
> keys will be pressed repeatedly, I have one thumb key on each side that
can
> activate this. This allows me to hold the layer key with a thumb on one
> hand and press keys with the other hand. I tried making this a toggle
> layer.

Cool! Glad you found this useful.

I've avoided recommending the use of keys that act as modifiers or
regular keys just because it's already so much mental overhead to make
the switch to the Atreus, but it's definitely a compelling feature for
advanced users. Do you think if someone didn't understand what was going
on they would be pretty confused if they activated it by accident?

I have been thinking of creating an "Advanced tips" section of the wiki;
this would be a great candidate for inclusion there; I'm sure folks can
think of other suggestions for that as well, so here it is:

  https://github.com/technomancy/atreus/wiki/Tips

While writing this I realized it would be good to create a listing of
the main layouts with descriptions, just to have them all collected in
one place:

  https://github.com/technomancy/atreus/wiki/Layouts

If anyone has suggestions for additional entries to either of these
pages please feel free to add them.

-Phil