FR and MF profile keycaps are designed to fit in gridfinity-keyswitch-bins when attached to a switch. Select which switches to target and the cap dimensions will update. For example, selecting
supported = [mx, choc_v2];will result in a shorter cap than selecting
supported = [mx];Customize width and height parametrically (only rectangular for now; no ISO enter or BAE).
// keycap width (cherry: 18, choc: 17.5)
keycw = 18;
// keycap height (cherry: 18, choc: 16.5)
keych = 18;
size = [1, 1];Tolerance requirement changes between materials, printer, etc. Here's some values found to work well:
- Bambu Lab P1S
- 0.4 mm Stainless Steel Nozzle
- Bambu Textured PEI Plate
| Filament | Tol |
|---|---|
| Overture Matte PLA White | 0 |
| Bambu Lab PLA Basic Orange | 0 |
| 3D BEST-Q PCTG Clear | 0.1 |
The earlier tests were conducted with PCTG. After switching to PLA the seam became visible. I noticed OrcaSlicer's Scarf joint seam (beta) option and looked it up. After applying settings from this guide, seams almost vanished. However, I switched from 3 back to 2 Wall loops to stop my OrcaSlicer from crashing every time I sliced. I also restored all of the Line width settings back to Bambu's presets and went back to the Classic Wall generator when seams on three out of the four center corners of the stem cross caused caps to sit skewed. You might also like to make surface lines vertical (change the Infill direction to 90°) to be parallel to the direction of finger travel.
Out of all options in OrcaSlicer, setting Top surface pattern, Bottom surface pattern, Sparse infill pattern, and Internal solid infill pattern to Hilbert Curve yielded the best clarity with transparent filament.
TODO: currently the skirt height is set to the stem height, it should be changed to the switch's top housing height.
TODO: stabilizers are not yet supported.
 |
 |
|---|
The stem on MX switches is 1.1mm thick horizontally and 1.3mm thick vertically. These keycaps are generated with symmetric stems, considering that the rest of the profile is symmetric. During testing, this was not found to cause fitment issues. Also, Choc v2 stems are symmetric, according to their datasheet. TODO: add the option for asymmetric stems, particularly for non-square caps.
A 5.5mm diameter stem was found to fit Outemu GTMX and Kailh BOX/Choc v2 switches. It should also fit Gateron KS-33 Low Profile switches (untested; based on datasheet).
TODO: Kailh Choc v1/Mini, Gateron KS-27 Low Profile stems are not yet supported.
// stem diameter
d = 5.5;This is a geometrically simple profile. It aims to provide a nice big flat top surface for legends (which could be multi-material 3D printed). To save time/material and allow (with clear 3D printing) decent optical clarity for seeing the switch underneath, the tops are thin, but not so thin that JLC3DP complains. There is room to make it thicker for a weightier (by about 25%) keycap.
The corner radius is concentric with the outside radius of the gridfinity-keyswitch-bins.
A real Gridfinity bin scaled-down to the same size as Machenna56k's Minifinity! Generated using the excellent gridfinity-rebuilt-openscad by kennetek.
The bin can be set to face up (stem on the bottom side)
 |
 |
|---|
or down (stem on the top side).
orientation = "up"; // [up: Up, down: Down] |
 |
|---|
The stem can be shortened for stackability, but this was found to make them prone to falling off.
stackable = true;
Down-facing caps can be printed flat, but not up-facing ones unless the stacking lip is removed.
// how should the top lip act
style_lip = 2; //[0: Regular lip, 1:remove lip subtractively, 2: remove lip and retain height] |
 |
|---|
TODO: multi-width caps (bigger than 1×1) are not yet supported. There's a 1-1.05mm gap between keycaps, but a 0.5mm gap between Gridfinity bins, which gets even smaller after scaling it down to less than half of its original dimensions. I tried changing the scale and the library's BASE_TOP_DIMENSIONS but was unsuccessful in getting things to behave in the desired manner.
Additionally, when facing down, the caps are too short to provide a deep enough cutout for switch's top housing clearance without cutting into the bases and leaving holes between them.
 |
 |
|---|
For even numbers of bases, when facing up, the stem will be in the middle and interfere with stacking.
Stem generation parameters are from Pseudoku (Asymplex Designs) under GPL-3.0. Therefore, keycaps in this repository are under that license.
Copyright (C) 2025 Dennis Lee
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.