Ionity Control Center — iCC

One unified list for everything that glows or spins in your PC. RGB detection & control · Fan telemetry · Lumina AI scene direction

Building Tomorrow, Today.

Download · Web docs · Wiki · FANZi IO-nity

========================================================================================
IONITY CONTROL CENTER (iCC) — RGB + FANS + AI, ONE SDK
Author: Johan Wilhelm van Antwerp | Ionity Global (Pty) Ltd | AEDI
Document ID: DOC-2026-08-002 | Version: 1.0.0 | Updated: 2026-08-11 SAST
Governance: Policy 986 AED | License: Apache-2.0 (signed, see NOTICE)
(c) 2018-2026 Antwerp Designs | Ionity Global (Pty) Ltd - All Rights Reserved - TM2
Web: https://www.ionity.today | https://www.ionity.world | Ref: https://www.ionity.co.za
Classification: PUBLIC | Building Tomorrow, Today. | Anything is Possible with God.
========================================================================================

Most RGB tooling stops at motherboards and RAM. Your case fans — the hardware that actually keeps the machine alive — are treated as an afterthought, split across vendor apps that don't talk to each other.

iCC puts lighting and airflow in one detected-device list, drives them with one SDK, and adds an AI that speaks human. It is the open companion to FANZi IO-nity, Ionity's AI thermal-intelligence suite (Fanzi.FanControl.exe ships in every release here).

Real output from a real machine (ASUS Z590 + Corsair DDR4 + Nuvoton Super I/O):

  provider openrgb   online
  provider fans      online

  [ 0] Corsair Vengeance RGB Pro DDR4  (Dram, openrgb) · 10 LEDs / 1 zones
  [ 1] Corsair Vengeance RGB Pro DDR4  (Dram, openrgb) · 10 LEDs / 1 zones
  [ 2] ASUS PRIME Z590-P               (Motherboard, openrgb) · 2 LEDs / 3 zones
  [ 3] Nuvoton NCT6798D Fan #1         (Fan, fans) · 679 RPM @ 25%
  [ 4] Nuvoton NCT6798D Fan #2         (Fan, fans) · 1133 RPM @ 95%
  ...

A .NET 10 library that detects every RGB device and every fan in the PC and merges them into one inventory.

• Clean-room OpenRGB-protocol client — talks to a running OpenRGB SDK server (hundreds of supported devices: motherboard headers, DRAM, GPUs, ARGB fan hubs, strips, peripherals). No GPL code inside; the SDK implements only the published wire protocol, which is why this repo can be honestly Apache-2.0.
• Fan provider — LibreHardwareMonitor-backed detection of physical fans (Super I/O, EC, GPU, AIO) with live RPM and PWM duty, including fans with no lighting at all.
• Provider plug-in model — implement IRgbProvider, register it, and your backend's devices appear in the same unified list. Direct-HID vendor backends are the roadmap.
• Effect engine — static, breathing, rainbow, wave and reactive frames computed on CPU and streamed identically to any addressable device from any provider.

await using var icc = IccDeviceManager.CreateDefault();
var inventory = await icc.DetectAsync();               // RGB + fans, one list

foreach (var device in inventory.Devices)
    Console.WriteLine(device);                          // fans report RPM/PWM too

var ram = inventory.RgbCapable.First(d => d.Type == DeviceType.Dram);
await icc.SetColorAsync(ram, RgbColor.IonityBlue);      // #00BFFF, of course

The AI this stack was missing: a scene director. You describe the mood; Lumina plans the palette, effect and tempo, and the effect engine plays it on everything.

icc scene "calm deep-sea vibe that pulses gently"
  → Ocean — Breathing · #003049 #0077B6 #00B4D8 #90E0EF · speed 0.4

• Two brains, one voice — with ANTHROPIC_API_KEY set, Claude (claude-sonnet-5) directs rich scenes; without it, a deterministic offline planner guarantees the same command works on any machine, no network, no account.
• Adaptive Ambience — maps live thermals onto a cool→hot gradient (brand-blue at idle, red under load) via the Reactive effect.
• Anomaly Sentry — per-fan rolling statistics that flag a stalling or stopped fan the moment it deviates from its own baseline (icc fans --watch).

A single self-contained executable (no .NET install needed):

icc detect                          scan RGB devices + fans into one list
icc set #00BFFF                     everything goes Ionity blue
icc effect rainbow --speed 2        classic, but on every device at once
icc scene "cyberpunk storm"         Lumina AI directs; your rig obeys
icc fans --watch                    live RPM + AI anomaly sentry
icc export --out inventory.json     machine-readable device inventory

flowchart LR
    subgraph AI["Lumina AI"]
        NL["natural language"] --> P{planners}
        P -->|ANTHROPIC_API_KEY| C["Claude planner"]
        P -->|always available| H["offline heuristic"]
        C --> S["Scene"]
        H --> S
    end
    subgraph SDK["IonityRGB SDK"]
        S --> E["Effect engine"]
        E --> M["IccDeviceManager"]
        M --> O["OpenRGB provider<br/>(clean-room protocol client)"]
        M --> F["Fan provider<br/>(LibreHardwareMonitor)"]
        M -.-> X["your IRgbProvider"]
    end
    O --> D1["Motherboard · DRAM · GPU<br/>ARGB hubs · strips · peripherals"]
    F --> D2["Case fans · CPU fans · AIO<br/>RPM + PWM telemetry"]

1. Download icc-win-x64.exe from the latest release (or grab Fanzi.FanControl.exe for the full FANZi experience).
2. For lighting: install OpenRGB and enable SDK Server → Start (iCC drives devices through it).
3. For full fan telemetry: run icc from an elevated terminal.
4. icc detect — and everything that glows or spins is on one list.

git clone https://github.com/Ionity-Global-Pty-Ltd/ionity-control-center-icc.git
cd ionity-control-center-icc
dotnet test                                   # 19 tests
dotnet run --project src/Ionity.iCC.Cli -- detect

src/Ionity.Rgb.Sdk/      the SDK: providers, protocol, effects, scenes
src/Ionity.iCC.AI/       Lumina AI: planners, adaptive ambience, anomaly sentry
src/Ionity.iCC.Cli/      icc.exe command line
tests/                   xunit suite (protocol, effects, AI planners)
docs/                    web app + docs (GitHub Pages)
wiki/                    wiki source pages
.github/workflows/       CI build/test + release packaging

• Direct-HID providers (Corsair/NZXT/Lian Li hubs) — no OpenRGB dependency
• Fan control (PWM write-back) with safety envelopes, unified with FANZi
• Ionity.Rgb.Sdk on NuGet
• iCC desktop shell (the GUI) with Lumina chat pane
• Scene marketplace on ionity.today

Apache License 2.0 — free for commercial and private use, modification and redistribution. Signed by Johan Wilhelm van Antwerp (Founder, Ionity Global) — see NOTICE. Ionity brand marks remain property of Ionity Global (Pty) Ltd (TM²).

Contributions welcome — see CONTRIBUTING.md.