# Introduction
[](https://github.com/roxaskeyheart/Chromatics/releases) [](https://github.com/roxaskeyheart/Chromatics/releases/latest) [](https://github.com/roxaskeyheart/Chromatics/releases/latest) [](https://discord.gg/sK47yFE)
**Join our Discord:**\
[](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 — not just visually, but correctly. Key positions map to the right physical keys, 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
{% hint style="info" %}
Single-zone and multi-zone-only keyboards only has limited support. For best compatibility, make sure your device support per-key LED illumination.
{% 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. There are no reported cases of Chromatics users being warned or banned, but caution is always wise.
See the [FAQ](https://docs.chromaticsffxiv.com/chromatics-4/support/faq) for more detail.
## Getting started
* [Prerequisites](https://docs.chromaticsffxiv.com/chromatics-4/getting-started/prerequisites) — what your PC needs before installing.
* [Installation](https://docs.chromaticsffxiv.com/chromatics-4/getting-started/installation) — step-by-step install instructions.
* [First Launch](https://docs.chromaticsffxiv.com/chromatics-4/getting-started/first-launch) — what to expect the first time you open Chromatics.
If you run into trouble, the [Troubleshooting](https://docs.chromaticsffxiv.com/chromatics-4/support/troubleshooting) page covers the most common fixes, and our [Discord](https://discord.gg/sK47yFE) community is always happy to help.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.chromaticsffxiv.com/chromatics-4/readme.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
