The mappings page allows you to setup the lighting exactly the way you like. A default profile is loaded when you launch Chromatics for the first time.

Chromatics 3 uses the concept of layers, you can setup multiple layers per device and map those layers to specific keys (or LEDs) on a device.

Layer Types

Base Layer

The base layer is always set as the lowest layer for each device type, it contains all keys/LEDs in a device. You can use this type of layer to set a solid colour over the entire device to build upon. This is a static layer that you cannot move, remove or add a new base layer.

Dynamic Layer

Dynamic Layers allow you to build out certain looks on your devices. There are many types of dynamic layers and you can add/remove specific keys from a dynamic layer.

Effect Layer

The effect layer contains all keys/LEDs of a device, and also can't be moved or removed. Most effects operate on this layer which is above all other layers.


Keyboard Layouts

Currently only one keyboard layout en-us is available on the mapping tab. This is a QWERTY keyboard so if you use a different layout, such as AZERTY you will need to remap keys accordingly.

Layer Bleeding

By default, colour palettes for each layer function have a negative colour. This means that when this layer has nothing to display it will display the negative colour, usually black.

For example, if you have the dynamic layer HP Tracker assigned to a set of keys and you were currently at 50% HP, half of your keys will be the HP tracker colour palette (default green) and half of your keys will be the negative color (default black).

When bleeding is enabled for a layer, instead of showing the negative colour, it becomes transparent instead allowing lower layers to bleed through.

Layer Modes

Certain dynamic layers support changing the mode of the layer.


When set to interpolate, the lighting of the layer's selected keys will be spread across those keys. This can give the effect of a bar across your device (e.g. health bar).


When set to fade, the lighting of the layer's selected keys will all fade between the two colour's. This mode is good for non-keyboard devices which don't necessarily have consecutive key layouts.

Last updated