Skip to content

Configuration

Modes

There are three modes for the configuration. This documentation is written for the Advanced mode. When you refresh the page, you might have to select the advanced mode again.

This documentation tries to cover all of the important settings. Some settings might’ve been left out, as they are easily understandable and documentation would not add anything of value.

  • Basic: Only shows the most used configuration options.
  • Advanced: Shows most things, that you’ll need to create your keyboard.
  • Expert: Allows to edit the code directly, to enable even more possibilities. See Expert Mode for that.

General

By default, all settings control both halves of the split keyboard. When you want to edit them separately, click the “Edit Separately” button.

Edit Separately Button

To go back to editing them together, click “Edit Jointly” and the values of the left half will be overridden by the values of the right half.

Upper keys

This section steers the general look / layout of the keyboard.

row selection

  • FN

  • Num

  • Out

  • Inner

Ø removes the keys and only leaves the thumb cluster.

The rxc button allows you to manually specify how many rows and columns you want.

The keycap and switch settings work the same as the ones in the edit key menu.

The horizontal and vertical spacing control the following:

horizontal and vertical spacing

Curvature

curvature

outwards arc

The tenting angle only changes the angle of the keywell, and not of the thumb cluster.

tenting angle

Thumb cluster

With the buttons, you can cycle through a few preset thumb clusters. You can also remove the thumb cluster with Ø. If you want to make a custom thumb cluster, choose one of the presets and then edit the keys manually. If you need more keys on the thumb cluster, make sure to select a thumb cluster key to add a new one to keep the clusters.

The curvature can be adjusted and changes the angle of the keys like with the keywell. This option only changes some thumb clusters, other presets are unaffected.

thumb cluster curvature

Case

Case modes

Default

The default mode creates the outer walls and a base. This can be subobtimal for high tenting angles, as there is a lot of unnecessary material (and a lot of supports).

The add lip options creates a little lip around the base. This hides warping and can create a cleaner look.

default case with lipdefault case without lip

default case mode

Stilts

The stilts case mode creates stilts for the keyboard to sit on. This works better for high tenting angles. This feature is experimental as of now, so not everything might behave as it is expected.

The tuck in bottom plate option hides the bottom plate behind the outer walls.

stilts case mode

Tilting base

The tilting base case mode separates the base into two pieces. There is a tenting part (the one with the slits) and the normal base. This enables you to print that part with less / without supports, and the top part with less supports. This setting also makes your keyboard a bit higher, so be aware of that.

The case tenting angle setting allows you to controll how much the bottom is tented, and how much is tented in the top.

The use pillars option allows you to remove the pillars, makin a solid base. You can also adjust how spaced out the pillars are. The first number specifies how thick the pillars are, the second number how much space there is in between the pillars.

pillar size

The raise case by option allows you to specify, by how much the upper case should be raised.

tilting base case mode

Other case settings

Connectors

You can add more / less connectors in the edit connectors dialog.

The bigger the X value for the custom position, the further away from the middle that connector is. The microcontroller holder will be generated for the values that you put in.

If you choose the type custom, you can specify what width and height you want. If you want to create a circle, set the width and height to the diameter and the radius to the radius. You can also set the X and Y position here.

For the connector index (L/R) see the expert documentation

Microcontroller holder

The microcontroller setting changes, for which microcontroller the holder is generated.

You can set the angle for the microcontroller. Be careful, too high values will mess the holder up.

Here you can see the holders for the microcontrollers.

Microcontroller with holders

Microcontroller without holders

Base settings

If you want to glue your base on (or fix it in any other way), turn off the fasten the base with screws setting. Below that you can choose how many, what screws and what fasteners you want to use (check screws and inserts for that.

You can also choose to not countersink the screws, but you will have screw heads sticking out of the bottom with this setting.

Wall settings

The rounded edge settings rounds off all of the “sharp” edges that were generated.

Normal walls

normal walls

vs smooth walls

smooth walls

With these settings enabled you get another pair of settings to controll the smoothing.

No wall shrouding

no wall shrouding

vs wall shrouding

wall-shrouding

The wall thickness controlls the tickness of the wall. If you make it thicker the footprint will get larger, as the additional wall is added on the ouside.

Minimum web thickness acts as compensation for thin web walls. Specifically, the targeted thickness of the web as a percentage of socket thickness.

The vertical part clearance adds clearance on the bottom so you have more space for wiring or other stuff.

The auto clear screw inserts adds additional height so that most screw locations are feasable.

Extras

Show wrist rest shows / hides the wrist rest.

Unibody

When activated, the unibody setting converts the keyboard to a unibody keyboard.

You can set the separation and the angle with their respective settings.

Wrist rest

Wrist position changes the position of your wrist of the hand scan. The move arrows on the wrist model can also be used, they do the same thing.

The max width changes the width of the wrist rest for its respective side.

The extension changes how far the wrist rest extends from it’s normal size. This can be set to negative values to make it shorter.

The attachment angle angles the wrist rests outward.

Tapers the sides of the wrist rest to make the non-keyboard side more pointy for a bigger angle.

Forwar slope adds a slope from the back up (with a positive taper value).

Tenting adds a slope from the outside to the middle (middle goes up with a positive tenting value).

wrist rest settings