Viewing Layout¶

Whether you are viewing a layout created by another community member or one of your own saved layouts, you will see a screen like the one below.

Layout sections¶

The available Layout Sections are the same as when editing a layout. For better readability, any empty sections will not be displayed.

Building and exporting¶

You can directly build the firmware or export the layout as DTSI .keymap or as JSON from this page using the controls at the bottom of the page.

Cloning the layout to edit¶

If you like to make edits to the layout, you need to first "Clone to Edit". This will replace the current layout being edited with a copy of the layout. The unsaved changes will be lost.

After cloning, you will be taken to layout editing screen.

Info

A saved layout in MoErgo Layout Editor cannot be further edited. It is immutable with a permanent unique UUID that identifies the particular layout.

If you need to change the layout, you will need to first "Clone to Edit"

Copying select layers from another layout¶

This functionality provides an easy way to create mash-ups. For example, if another layout has one or more layers that you want to use, this feature lets you copy the selected layers into the layout you are currently editing.

When you copy a layer, any macros or hold-taps referenced by that layer are also copied over. If your layout already has macros or hold-taps with the same names, the Layout Editor will resolve these conflicts:

If the items have the same name and the same parameters, the existing item in your layout will be used.
If the items have the same name but different parameters, the copied item will be renamed automatically.

This automatic copying is a powerful feature, making it possible to create and share single-purpose layouts for specific apps and games.

Note

After the copying the layers, you may need to resolve issues so that the layout is correct and can be saved and built.

If the copied layers' names collide with the layers already in the layout being edited, you need to rename the layers to resolve the name collisions
If the copied layers and macros refer to layers that weren't copied, the references will need to be resolved.

To share a saved layout, simply copy its URL. Please note that anyone with the URL can view the layout, even if it has Unlisted visibility.

Printing¶

When you are learning a new layout, it can be useful to print a physical copy. To do this:

Select the layer you want to print.
Use your browser's print function (typically Ctrl+P or Cmd+P).