# How to use an RGB fan with Framework Desktop (AMD Ryzen™ AI Max 300 Series)

> To use an RGB fan with your Framework Desktop there are a few things you need to know Framework Desktops support ARGB fans and other RGB devices that use the 

Source: https://knowledgebase.frame.work/en_us/how-to-use-an-rgb-fan-with-framework-desktop-amd-ryzen-ai-max-300-series-HyIojpCIee

Last updated: 2026-01-13T22:50:33.083Z

To use an RGB fan with your Framework Desktop, there are a few things you need to know. Framework Desktops support ARGB fans and other RGB devices that use the standard 3-pin ARGB header at the hardware and BIOS level.

We’ve explained the steps for both Windows and Linux users below. In the future, we’re adding easier tools, including integration with Windows Dynamic Lighting and other user-friendly software. For now, you can test RGB features and manually control your RGB fan using the framework\_tool debug utility.

#   
Using framework\_tool

## Windows

Requirements: Framework Driver Bundle installed.  
Download: [https://github.com/FrameworkComputer/framework-system/releases/latest/download/framework\_tool.exe](https://github.com/FrameworkComputer/framework-system/releases/latest/download/framework_tool.exe)  
Or install using winget in the Terminal: winget install FrameworkComputer.framework\_tool

*   Navigate to the folder you downloaded framework\_tool.exe to
*   Right click in the background area of the folder, and click "Open in Terminal"
*   In the Terminal window, run: .\\framework\_tool.exe --rgbkbd 0 0xff0000 0xff8000 0xffff00 0x00ff00 0x00ffff 0x0000ff 0x8000ff 0xff00ff
*   In the new window that says "Do you want to allow this app to make changes to your device?", click "Yes"
*   You’ll then see the RGB fan change colors.
*   ![](https://cdn.kustomerhostedcontent.com/media/6047cd84502177bce9fccae2/d5d02f8ee4dd29e0405565d2579f1e0a.png)

  

## Linux

Requirements: Linux kernel >= 6.14.3

Github: [https://github.com/FrameworkComputer/framework-system/](https://github.com/FrameworkComputer/framework-system/)  
Arch package: [https://archlinux.org/packages/extra/x86\_64/framework-system/](https://archlinux.org/packages/extra/x86_64/framework-system/)  
NixOS Package: [https://search.nixos.org/packages?channel=25.05&size=1&show=framework-tool](https://search.nixos.org/packages?channel=25.05&size=1&show=framework-tool)

sudo framework\_tool --rgbkbd 0 0xff0000 0xff8000 0xffff00 0x00ff00 0x00ffff 0x0000ff 0x8000ff 0xff00ff

  

Our guide for using a Linux binary to run the framework\_tool: [https://knowledgebase.frame.work/framework-system-on-linux-a-tool-to-monitor-configure-and-update-framework-laptop-hardware-HJbak1uRel](https://knowledgebase.frame.work/framework-system-on-linux-a-tool-to-monitor-configure-and-update-framework-laptop-hardware-HJbak1uRel) 

  

### Usage

*   The Cooler Master ARGB fan that we offer with the Framework Desktop has 8 LEDs, which is why the example commands above have 8 color parameters in them.  Fans with other LED counts could require other numbers of parameters.
*   The system supports more than 8 LEDs at a time (eg: an LED matrix), but you should keep in mind that there is a 2.4A power limit on the ARGB connector.
*   You can use [https://en.wikipedia.org/wiki/Web\_colors](https://en.wikipedia.org/wiki/Web_colors) to find example colors, making sure to format the colors as “0x” followed by the six hexadecimal characters (0-9 and A-F)