How to build your first mech keyboard

So, this blog post will be about how to build a mech keyboard.

Meanwhile, you do somehow need to understand some basics about mech keyboards.

That’s why, until I do write one, I can recommend the one done by Drop.

Get the parts

Disclaimer: So, the initial thing will be to fetch the needed components. For that, I’ve already did the job of choosing something decent. Take note that price-wise, you can start at 150$ and go beyond 1000$.

Here, the budget will be about 330$ but you can also buy a cheaper case or switches. 👌

You can also notice that unlikely some other well known guide, I’m not going to make any solder here, the PCB is indeed hotswappable aka “plug and type”.

For several reasons: it’s more time consuming - especially in case of a bad soldering - and it’s removes the ability of quickly trying switches in the future (thing that may be interesting for somebody new to the hobby). It also requires a soldering iron and some basic dexterity to make something clean.

If it’s your thing, feel free to buy a regular PCB and solder it yourself, it’s a lot of fun too. 👷‍


En voici la liste avec un lien cliquable sur chaque composant et son prix

To that, we may add some additive tools.


You should already have some of those to help you during the process

  • metalic twizzers
  • cutting pliers
  • screwdriver
  • scissors
  • band aid

All of those may be available with free shipping and be delivered within business 10 days.

Received packages

Ooopa ! Just got the packages, time to start building. 💪

Case + Sortbothane + PCB + Plate Remaning tools

This is pretty much all the things that you will need.

Switchs

The most important thing of course.

Various switches

Here is a quick overview of some of the best switches out of the box (bought from ZealPC).

From top to bottom, we do have:

  • x70 Zealios v2 67g: tactiles and light
  • x70 Zilent v2 65g: tactiles, silent and light
  • x10 Zilent v2 78g: tactiles, silent and heavier
  • x70 Healios 67g: linears, silent
  • x10 Rosélios 67g: linears and silent but pinky ! (yes, pure design)

For our build, we gonna use some Zilent 65 and 78g because of their smoothness and silence. 😴

Oh and you can use any other common switch too (if it’s MX cherry compatible).


Quick reminder of our build

Exploded internals of a keyboard

From bottom to top.

At first comes the case, it will essentially impact the sound and the feel. It can be of various price depending of the quality of the materials (and it’s thickness).

Then comes some kind of dampening foam to absorb the sound propagated during a keystroke.

Then, our beautiful and programmable PCB. Responsible for a lot of awesome workflow (with QMK).

The stabilizers are above the plate in the schema but they actually need to be mounted before the plate (even if the PCB is hotswappable). They are used on bigger keys like Caps lock and Left Shift, that may lean on one side of the switch without it when pressed, because a single switch is used for a single keycap (aka 1u) by nature.

You can follow that Keycap Ruler link and compare it to your own keycap location. A stab is usually used on keys that are 2u or above.

Something similar may be found on the QMK config after toggling on show key sizes on the right’s side navbar (with the gear on it).

The plate arrives next. It’s not mandatory by itself but we will use one in our build. Usually, people tend to go “plateless” for more robust typing feedback. The plate helps keeping the switches sturdy on place, to not let them wobble or simply pop off.

The most important part, are of course the switches. Feeling, sound, feedback are some of the most noticeable things about them. Notice that in our build, we do not need to solder, which is a great way of winning some time and avoid further issues.

Finally, do come the keycaps that suit your texture feel, profile shape, colors and theme. Quite as much important as the switches since they will be in direct contact with your fingers.

PS: I personally do hate Signature Plastic ABS plasic on SA profile keycaps. But it is really, a personnal taste at the end of the day. 👌

Quick overview of the PCB

Front of the PCB

In pink, we do have our USB-C port.

In blue (follow the numbers order), are our locations when screwing the PCB into the case.

In red, we do have the RGB LED, if it’s your thing. 😏

In green, it’s the location of the switch’s stem.

In orange, are the slots for the little plastic pins of a switch, we will cut them just in a few seconds. They may be useful for some plateless build but since we do have a plate and are planning (sometime at least) to remove our switches to try some other ones, they are not so clutch.

In yellow are the slots for the metallic pins that are making the contact when the switch’s internals hit the leaf (during a keystroke).

Back of the PCB

For this part, no need to know a lot of things really.

The switch button shown in blue can be useful thought. It’s used to flash the PCB (essentially at the beginning) by setting it’s position to BL (BootLoader). We will bind a key press for that feature after the first flash. 👼

In red, we do have the Kailh sockets. Those are the ones that allow us to not have to solder. You simply need to fit the switch inside of it and tada ! 🎊

Meanwhile, be careful to do it on a flat table surface to not pop off the solder socket 😱 (may happen if you force 💪 at the same time as holding it with one hand mid-air).

Checking the PCB

Time to check if the PCB is working as expected. Usually they are totally fine.

For that, go to your computer, plus the PCB with the USB port and go to that link to check if everything is fine.

For that, close the circruit with some metallic twizzers by shorting the 2 little holes (for the switch’s metallic pins). You may notice that the various letters of the keyboard may light when you do that.

Testing the PCB

If some of the slots shown by the 4 blue arrows are not corresponding to what you’d expect on the screen, do not panic. Some may even not trigger anything at all because used as a Fn key.

The goal is to check that those basic circuits are fine !

If nothing is happening and your BootLoader switch is in the Normal position, it may be an issue. But before sending it back, let’s try to flash the PCB.

I’ll write a tutorial soon, on how to do it on Windows, MacOS and Linux. Stay tuned.

Time to build

Clipping the switches

Clipped switches

Cut those plastic legs !

Clipped switches sideways

Sideways POV.

Switchs restants

Some more to go. 👩‍🏭

Modding the stabs (or stabilizers)

The 4 little ones will be used for:

  • (left) shift
  • backspace
  • enter
  • (right) shift

The biggest one will be for the spacebar.

stabs

So, we gonna start by opening them gently (remove the wire from the plastic elbow).

Stab sideways

It’s time to clip those small little plastic legs too. That way, your stab will rattle less, will last longer and it will help the overall quietness.

Clip those

Gonna lube a bit, to prevent friction.

Superlube + paintbrush

Take your Superlube and your 5/0 sized paint brush. 🖌

Dip the tip of the brush into the tube, but don’t take too much of it, only a small layer is needed.

The most important thing to get here is that: it’s far better to have less lube, that to have too much of it. Trust me, if you overlube it, you will get a bad result too and it will be a PITA to remove, so keep it light. 🍃

Inside of the stab

Put a very thing lube on this wall, just enough to get it a bit shiny. Do the same for the opposite wall. 😉

Gonna lube the metallic wire that will make contact and potentially rub against everything. Here, you can apply a bit more of lube (essentially for the spacebar).

Lube the wire

Put it pretty much everywhere, essentially on the elbow.

To get it back, look for the correct side.

Put the stab back

Here, we gonna need to:

  1. put back the little part on the correct side, inside of the base
  2. slide the wire into the bottom hole and double check that it is going deep enough
  3. clip it on the elbow, as it’s initial position

Tada, you should have some clipped and lubed stabs by now! 🎊

Clipped & lubed stabs

We are going to screw them into the PCB thanks to the screws present in our package. It is used essentially to prevent a short.

Oh and be careful of the orientation of the stabs, because there is one ! We are going to mount them as shown above. 👆

[Optional] Band-aid

Click here to expand

We are going to make another mod now, aka the bandaid one (for more silence, again).

It consists of cutting a small amount of pad, lube it (with the Superlube again) and stick it to the correct place on the PCB.

Location of the pads

Watch out to have the width of the pad to be large enough because this is the part responsible for the stab damping.

Lubed pad

Done, with the lube. You can also check out that the lube is changing color - means that there is enough of lube.


Time to mount it all !

Screwing the stabs

Nothing specific here, pass through the plastic legs and screw the stabs into the indicated slots.

Stabs mounted

This is how it should look like with all the stabs modded and mounted.

You could now mount some switches in the corners to apply some equal force (to not bent the plate).

Plate with switches

During the switches insertion, you can also put some bubble wrap under below it (the one received in the package will be totally fine for that job).

⚠️ Indeed, I remember you that even if the hotswappable sockets are already soldered, they may break off if there is too much (uneven) force applied on it (like when holding it mid-air). So, if you don’t want to get out the soldering iron, keep easy on that part. Oh and second little warning, did you noticed the 2 reversed holes on the top left ? 🌵⚠️ (it’s because of the USB port)

If you ever twist some of the metallic legs of a switch, you can put them back with your finger or a plier.


You can now mount some keycaps right now to try out the stabs. It will allow you to not have to get back to them once everything is mounted. On top of enjoying the tasty sound, they are doing. 👌

To mount the keycaps, firmly press on it, like if it’s your first time trying to escape VIM by pressing the esc key. 😉😆

Final rush

Putting all the switches in place

Now, put all of your lovely switches.

Your tasty switches

You can like me, put some heavier ones (dark blue colored) on some keys. Personnal preference.

Switch army

Check that all the switches are perfectly aligned and firmly stuck in the plate, in the good position, without any twist. You can also double check your PCB on your computer at this point if you wish, to be sure that every key will be functionnal at the end.

Time to put everything in your aluminium case now.

[Facultatif mais très recommandé] Matière anti-acoustique

Cliquez ici pour développer cette partie Quand vous allez taper sur votre joli boitier en alu, il y aura des vibrations qui vont se propager un peu partout dans le vide, entre le fond du boitier et votre PCB.

Il est donc possible de réduire cela avec de la matière anti-acoustique. Vous avez globalement le choix de la matière que vous voulez. Vous en avez pour tous les prix, il suffit juste qu’elle ne soit pas trop épaisse ni trop fine.

Ici, j’ai pris de la Sorbothane parce que c’est considéré comme une très bonne gomme anti-acoustique (si on ne part pas sur de la gomme professionnelle, bien sur).

Il faut cependant savoir que c’est une gomme très embêtante a manipuler…

La Sortbothane

Voici ce que j’ai reçu. Il suffit maintenant de découper ca proprement (enfin comme on peut !) pour que ca rentre bien au fond du boîtier.

En mesurant bien avec une règle, en découpant de manière droite, vous aurez déjà un bon périmètre.

Il faudra cependant en plus, faire des trous au centre aussi, afin de pouvoir laisser passer les vis a travers et viser le PCB. Pour cela, une lame 🔪 et des ciseaux ✂️ pointus afin de “couper en pinçant au centre” me semble être la meilleure technique.

Il y a peut-être d’autres moyens + propres. Mais dans tous les cas, cela reste une matière pas très pratique a modeler…

Résultat final de la découpe

Tada ! Pas fameux hein…? Mais ca donne un ordre d’idéee sur les découpes nécessaires et ca vous donne un visuel du rendu !

Mounting it into the case

Almost done

Now, put the PCB in place by passing the USB part in first. Also, double check that the Bootloader swtich is in the NORMAL position. 🙏

Screw time

Screw gently (to not break the PCB). Use the golden screws and aim for the correct locations (can be found here if you forgot).

Keycaps

Mounting the keycaps

Same as before, put the reamining keycaps in place by pressing them firmly. Try to respect the rows too ! Indeed, the row of QWERTY and `12345 have some specific profile, and as so, you cannnot interchange them or you will have a hell of a strange typing experience.

Result 💮

Front keyboard

Congratz for your first build ! 🎊

Misc stuff

Some more stuff.

Non-skid legs

Do not forget to put your non-skid legs under your case, it will help you get more grip and will protect your case.

PS: The small hole in the case is essentially used to flash the PCB by triggering a specific button. We don’t really care of that one since we will flash it in another way (so don’t worry about it). It here because it’s a universal case with a large compatibility with other PCBs.

How to flash your PCB ?

”Ok dude, it’s fine and all but how do I actually custom my keeb with some fancy marcos, mapping, l33t RGB ???”

It gonna depend of your OS in first place, let’s say that it’s really simple on MacOS, simple enough on Linux and annoying on Windows. I will do a guide soon for the 3 OSes. Until then, you can follow the somewhat messy official guide.

MechMerlin (a community member) also did a great playlist on how to flash it. You can follow that one until I release my own guide for it.

What’s next ?

If you have some questions, remarks or suggestions, feel free to hit me up on Twitter @kissu_io or send me at [email protected] ! 👍

On my part, I will soon release some other guides on:

  • properly & simply installing QMK on any OS
  • silencing your whole keyboard to make it even more silent
  • introduction to some advances QMK features