> For the complete documentation index, see [llms.txt](https://docs.chromaticsffxiv.com/chromatics-4/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chromaticsffxiv.com/chromatics-4/readme.md).

# Introduction

<div align="left"><img src="/files/e3Pej0RsSLnhXcbGvTCG" alt="Chromatics Logo"></div>

[![Github All Releases](https://img.shields.io/github/downloads/logicallysynced/Chromatics/total.svg)](https://github.com/logicallysynced/Chromatics/releases) [![Github Latest Releases](https://img.shields.io/github/downloads/logicallysynced/Chromatics/latest/total.svg)](https://github.com/logicallysynced/Chromatics/releases/latest) [![Latest Release](https://img.shields.io/github/release/logicallysynced/Chromatics.svg)](https://github.com/logicallysynced/Chromatics/releases/latest) [![Discord](https://img.shields.io/discord/334196655131721741.svg)](https://discord.gg/sK47yFE)

**Join our Discord:**\
[![](https://discordapp.com/api/guilds/334196655131721741/widget.png?style=banner2)](https://discord.gg/sK47yFE)

## Welcome to Chromatics 4

Chromatics is a free companion app for **Final Fantasy XIV** that turns your RGB devices into an extension of the game. Your keyboard, mouse, headset, light strips, and smart bulbs can follow what's happening on screen - reacting to your health, your job, the weather around you, and much more.

Chromatics 4 is a complete, modern rebuild of the app. It uses a new UI built on Avalonia, the latest RGB.NET release and a rebuilt backend - so it runs smoothly, looks great, and supports more hardware than ever.

## What Chromatics can do

Chromatics ships with a large library of lighting scenes and effects. A few of the highlights:

* **Player vitals** - HP, MP, GP, and CP displayed live across your keys.
* **Job Gauges** - job-specific gauges for every combat class.
* **Cast bars** - your cast and your target's cast progress.
* **Keybind lighting** - keys light up based on whether an ability is available.
* **Battle Stance** - your whole setup shifts colour the moment you enter combat.
* **Enmity Tracker** - instantly see your aggro status at a glance.
* **Reactive Weather** - zones paint themselves with static or animated weather.
* **Raid Zone Effects** - supported encounters take over your lighting with choreographed animations.
* **Audio Visualizer** - your keyboard becomes a spectrum analyser driven by the game audio.
* **Screen Capture** - ambient colours sampled from the game window spill across your devices.
* **Duty Finder Bell** - devices flash when your queue pops.
* **Damage Flash** - a sharp flash when your character takes a hit.
* **Title screen and cutscene animations** - subtle flourishes for the quieter moments.
* **Gold Saucer Vegas Mode** - because of course.

## What's new in Chromatics 4

Chromatics 4 is a complete rebuild - same idea, much better everything. If you're coming from version 3, here's what's worth knowing:

**Looks and feels completely different (in a good way)**\
The entire interface has been rebuilt from scratch. It's cleaner, faster, and comes with light and dark themes. The Mappings tab now has a live visual preview of your layout so you can see exactly what you're building.

**Non-English keyboard? It finally works properly**\
QWERTZ and AZERTY layouts are now fully supported. Keys you press and keys that light up match the physical layout, and layout-aware effects like Audio Visualizer work on them too. Set your layout once in Settings and everything adjusts automatically.

**Two brand new lighting modes**\
The **Audio Visualizer** turns your keyboard into a real-time spectrum analyser driven by the game's audio output. The **Screen Capture (Beta)** samples colours from the game window and spreads them ambience-style across your devices.

**More devices supported**\
**OpenRGB** is now supported, which means Chromatics can control a huge range of devices that weren't possible before. **Philips Hue (Beta)** is also supported for the first time.

**A lot of long-standing bugs are gone**\
Layer settings getting lost after a session, lighting stopping after FFXIV connects, the Enmity Tracker showing the wrong colour, crashes on exit - all fixed.

**Available in your language**\
The app is now fully localised into English, French, German, Spanish, Japanese, Korean, and Simplified Chinese.

## Device compatibility

Chromatics uses [RGB.NET](https://github.com/DarthAffe/RGB.NET) to talk to your devices. If your device is supported by RGB.NET (or by one of the extra providers Chromatics adds), it will work with Chromatics. Supported vendors include:

* Asus
* Cooler Master
* Corsair
* Logitech
* MSI
* Novation
* Razer
* SteelSeries
* Wooting
* **OpenRGB** - any device exposed through an OpenRGB server
* **Philips Hue** - Hue bridges and compatible bulbs
* **PlayStation (Beta)** - DualShock 4 and DualSense controllers over USB or Bluetooth, including the lightbar and player-indicator LEDs
* **LIFX (Beta)** - bulbs, multi-zone strips (Z, Beam, String, Neon) and matrix devices (Tile, Candle Color) on your local network
* **Yeelight (Beta)** - bulbs, light strips, and lamps on your local network
* **Windows Dynamic Lighting (Beta)** - any Razer, Logitech G LIGHTSYNC, ASUS ROG, HyperX, MSI, SteelSeries, HP, or Omen device Windows exposes via the Dynamic Lighting standard (Windows 11+)
* **Alienware (Beta)** - AlienFX hardware on Alienware chassis and Dell G-series machines
* **QMK (Beta)** - custom keyboards running QMK firmware with Raw HID, including NovelKeys, KBDFans, Drop, GMMK, and Glorious boards
* **EVision (Beta)** - Sonix VS11K28A firmware keyboards, including the Glorious GMMK TKL and Redragon K550 / K552 / K552-2 / K556
* **Redragon (Beta)** - Redragon RGB mice on the OpenRGB HID protocol family, including the M711 Cobra, M715 Dagger, M716 Inquisitor, and M908 Impact

{% hint style="info" %}
Single-zone and multi-zone-only keyboards have limited support. For the best experience, use a keyboard that supports per-key lighting.
{% endhint %}

## Is Chromatics safe to use?

Yes. Chromatics reads game memory to follow what's happening in FFXIV, but it does so strictly read-only - it never writes to, modifies, or injects into the game in any way.

We still recommend not discussing third-party tools in-game, since technically any third-party interaction is discouraged by the game's terms of service. No Chromatics user has been warned or banned that we know of, but it pays to be careful.

See the [FAQ](/chromatics-4/support/faq.md) for more detail.

## Getting started

* [Prerequisites](/chromatics-4/getting-started/prerequisites.md) - what your PC needs before installing.
* [Installation](/chromatics-4/getting-started/installation.md) - step-by-step install instructions.
* [First Launch](/chromatics-4/getting-started/first-launch.md) - what to expect the first time you open Chromatics.

If you run into trouble, the [Troubleshooting](/chromatics-4/support/troubleshooting.md) page covers the most common fixes, and our [Discord](https://discord.gg/sK47yFE) community is always happy to help.