Default Spanish Layout First Thoughts

Hi everyone,

This my first post in this forum. I received my Model01 a couple of weeks ago and I’ve been training on 15 minutes a day. I’ve improved from 12 wpm to 50 wpm.

I’ve been using Model01 connected to a Win10 computer using default OS layout for Spanish (Spain).

These are my initial thoughts after two weeks:

  • The modifier key for the apostrophe is a real pain. In Spanish maybe 1 on 4 words needs a special character like áéíóú. You have to press this modifier and then press the vocal. This key is pressed with the pinky and the shape of key itself is not very friendly. (My initial thought is to move it to the “any” key)
  • I’ve tried lots of combinations but I feel I cannot trigger some characters like []{} (Upon reviewing the layout by @jordihs I’m wondering they might be on the other half).
  • The symbol are on the right hand side is a miss and miss area. Some of the key printing is on the right spot. Some other are completely random. I’ve to type every “-” three or four times before hitting the right key.

I’d love to share my current mapping with other people interested and propose new ideas for the Spanish (Spain) users.


Hola César!
Keep in mind that my layout is just an idea that needs to be implemented using the firmware modifications that you make by altering the source using the Arduino IDE. It is not the default layout at all. I am a programmer and thought it might be interesting to have these frequently used keys for programming in a handy location.

I think that you have that problem because in the layout by default there is no alt-gr key (both alt keys trigger left-alt by default). To get alt-gr you must add it to the layout explicitly. Then you would be able to print these symbols, although I think the location for each one will not be exactly the most convenient. The } in spanish is mapped to altgr+ç which may even be absent completely, I’m not sure.

I’m just guessing because I still don’t have my keyboard yet, hopefully it will arrive on april or may.
By all means, do share your layout, it would help your fellow spaniards get ideas on how to map things.
I would not remap ´ to the any key by the way. I would send you way off the home row any time you have an accented vocal. Maybe you should try hitting the default key from a different angle… or place it elsewhere but not so far from the home row.

Un saludo

1 Like

In the default mapping the AltGr key is mapped to the Butterfly button. I realized it as I was looking to remap it to that key :wink:

I need to check out the plugins and figure out the best way to input accented vocals. I assume there might be other custom ways to add it, using macros, chords or novel input methods. I’m wondering if fn+vocal could be something feasible.

Let’s explore it and thanks for your input!

1 Like

I thought about fn+vocal, but I discarded that because it would limit my ability to create a sound second layer for coding. Might work for you though.

By the way, off topic question, since you are from Spain: How much did you pay in import tax?

Import taxes were 35-40 EUR aprox. They were handled by UPS and I had to make a cash payment upon delivery.

Thank you very much!

Hi, @elsatch

I’d be interested in your opinion of the merlin3 layout in - this is a joint attempt to optimise the model01 firmware layout for European Spanish OS keymap. European Spanish is one of the most difficult layouts to work around, I have found…

1 Like

I’m guessing that to figure out that, I need to look at an american english layout image side by side with the EU spanish layout so that I can ‘translate’ variable names like KEY_QUOTE to their actual meaning here (in the example, the ´ accent).
Would you like to get a pull request with added comments that clarify this?

Problem with adding language-specific comments is that the layouts are designed for multiple languages and so it would get very large if I included them all. The USB HID standard made a fundamental mistake when it labelled the scancodes with their US-QWERTY interpretations instead of some language-independent labels.

As an alternative, you could try the visualiser in . I can run off a batch for you if you can’t run it on your own machine.


I just meant adding comments for the specific aliases-abg-orphans-merlin3.h file, not for the whole thing. Other people might want to add their own language comments to other specific files… Or am I misunderstanding here?

merlin3 should work (reasonably) for eu spanish, swiss french/german, and canadian french, so even that might get too large. You’re right, there should be a table somewhere for what the key meanings are in each language/layout combination, but I’m not sure the .h file is the right place for it.

Tell you what, give me until lunchtime today and I’ll throw together a mapping table for each of the orphans files. Shouldn’t take me too long…

That should be very helpful, thank you.

How’s this?


It’s great, Andrew. Makes it so much easier to understand. Thanks a lot.

Thanks for the suggestion @andrewg. I’ve had a couple of busy weeks. I’ll try your layouts and report feedback as soon as possible.

Hi, Jordi! I’m from Spain and I would like to have a keyboardio. Do you have a spanish keyboard layout? Are your keys printed with spanish characters and can you buy something like that? Thanks

Hi! I have my layout in Spanish but it is custom designed for writing code. If you code yourself then it might be useful for you. You can see it here:
The blue keys are the function layer and the red ones are the numlock layer. The thumb keys are mapped for tapping once and you get brackets etc. But if you hold and press other key they work as normal shift, ctrl and alt.
The keys are not printed in Spanish and it is not possible to get them in Spanish. Other keys will be available soon but not in our language unfortunately.
If you like my layout I will be happy to share the code to flash it. Cheers!


It seems to be a really nice first step for me! I think I can use it for learning with keyboardio and later I’ll try to make some changes if necessary. I would like that you share the code with me! Thanks a lot, Jordi.

Oh, it’s been such a long time since we started this thread! I have not been able to get used to the keyboard layout. I tried as I was preparing a long text and typing felt quite uphill. And right now, I’m into the writing again.

I’m planning to sell my keyboardio, so I can’t contribute much to this topic at the moment :frowning: