Skip to content
This repository has been archived by the owner on Sep 3, 2021. It is now read-only.

Latest commit

 

History

History
147 lines (126 loc) · 8.53 KB

README.md

File metadata and controls

147 lines (126 loc) · 8.53 KB

MSIRGB is an alternative to MSI Mystic Light for controlling motherboard LEDs & 5050? LED strips. Unlike Mystic Light, there is no limitation to 7 fixed colours.

Aside from providing a GUI for quickly experimenting with different basic effects, it also provides a scripting interface to create more advanced effects like this one and to auto-run these effects on Windows startup.

Many thanks to nagisa/msi-rgb which helped me start this project.

NOTE: MSIRGB is in bug-fix only-mode. No new features will be added, so don't bother asking. Lua scripts already allow you to do whatever you might feel like doing, within the boundaries set by hardware limitations.

How to use

  1. Check if your motherboard is supported here. If it is, you may proceed. If it isn't, it's possible the program won't work with your motherboard. Other MSI motherboards may be supported despite not being listed. Non-MSI motherboards are not supported and MSIRGB will not run on those. I provide no warranty should your motherboard malfunction.
  2. Make sure you're running a 64-bit release of Windows 10.
  3. Make sure you don't have any anti-cheat enabled. Riot Vanguard and FACEIT Anti-Cheat are known to block MSIRGB from running.
  4. Follow the instructions here to download & install MSIRGB.

Example effects

Hue Wheel

How it works

MSIRGB

When you run MSIRGB, you will see this GUI. Here you can experiment with simple effects by changing hardware-implemented settings in your motherboard.

  • Colours: You can choose to change between 8 different colours. The order by which the motherboard switches between them is from left to right, and then right to left, as displayed. You can choose from 4096 different colours (4 bits per channel, hardware limited).

  • Invert channels: RGB values as displayed in the GUI are inverted when shown in the LEDs. This is a setting on the chip that apparently creates more vivid colours.

  • Step duration: This is the interval of time between each change of colour. Possible values are 0 to 511, inclusive.

  • Breathing mode: This is one of the two flashing modes supported by all the motherboards that MSIRGB targets. Breathing mode flashes from on to off and back again by gradually changing brightness. The speed of this effect cannot be changed.

  • Flashing mode: This other flashing mode flashes from on to off and back again instantly, and the speed of the effect can be changed to different preset values.

  • Scripts: Scripts allow you to leverage these hardware-implemented functions to create more advanced effects. While the functionality provided by the motherboard seems minimal, you can create some interesting effects with them. Currently MSIRGB has a few example effects you can download and try: the hue wheel effect, the strobe effect, the police lights effect, the heartbeat effect and the pumpkin effect. New effects are always welcome. Feel free to open a pull request if you'd like to contribute (I apologise in advance for being so nitpicky about code quality).

Scripting interface (for creating effects)

Learn more about how to create scripts and find the Lua API reference in the wiki.

How to install

  1. Install VC Redist 2019 x64.
  2. Download the latest release.
  3. Unpack the archive from 2. into any folder.
  4. Run MSIRGB.exe. It'll ask you for administrator privileges. This is required to access the hardware.

Motherboard support

This is not an exhaustive list of all motherboards supported by MSIRGB. There may be others not listed here that also work. It may also be the case that some of these aren't actually supported. Running MSIRGB on an unsupported motherboard and ignoring the warning message on startup may lead to damage to your data or the motherboard. Do it at your own risk.

This repository is archived, therefore this list may be out-of-date. The following list was correct at the time of archival. More motherboards may work.

  • B450I GAMING PLUS AC (works)
  • X470 GAMING PLUS (works)
  • X470 GAMING PRO (works)
  • X470 GAMING PRO MAX (works)
  • Z270 GAMING M7 (works)
  • B450 TOMAHAWK (works)
  • B450 TOMAHAWK MAX (works)
  • H370 GAMING PLUS (works)
  • B450M MORTAR (works)
  • B450M MORTAR TITANIUM (works)
  • B450M BAZOOKA PLUS (works)
  • B250M MORTAR (works)
  • B350M PRO-VDH (works)
  • B450M BAZOOKA V2 (works)
  • B450 GAMING PLUS (works)
  • B250M BAZOOKA (works)
  • Z270 GAMING M6 AC (works)
  • Z270 GAMING M5 (works)
  • B360M GAMING PLUS (works)
  • X370 GAMING PLUS (works)
  • B450-A PRO MAX (works)
  • B450M PRO-VDH MAX (works)
  • MPG Z390 GAMING PLUS (works)
  • B450 GAMING PLUS MAX (works)
  • B450M MORTAR MAX (works)
  • B450M PRO-VDH PLUS (works)
  • A320M GAMING PRO (works)
  • B365M PRO-VDH (works)
  • Z370 PC PRO (works)
  • B350 TOMAHAWK (works despite giving warning message on start)
  • B350 GAMING PLUS (works despite giving warning message on start)
  • B350 PC MATE (works despite giving warning message on start)
  • A320M BAZOOKA (works despite giving warning message on start)
  • B350M MORTAR ARTIC (works despite giving warning message on start)
  • B350 KRAIT GAMING (works despite giving warning message on start)
  • X370 KRAIT GAMING (works despite giving warning message on start)
  • B350M MORTAR (works despite giving warning message on start)
  • Z270 GAMING M3 (works despite giving warning message on start)
  • H270 GAMING PRO CARBON (works despite giving warning message on start)
  • B350M BAZOOKA (works despite giving warning message on start)
  • B250M GAMING PRO (works despite giving warning message on start)
  • B350 GAMING PRO CARBON (works despite giving warning message on start)
  • B350I PRO AC (untested, should work)
  • B350M GAMING PRO (untested, should work)
  • A320M GRENADE (untested, should work)
  • B450M PRO-VDH (untested, should work)
  • B450M BAZOOKA (untested, should work)
  • Z370 OC GAMING (untested, should work)
  • Z370 GAMING PLUS (untested, should work)
  • Z370M MORTAR (untested, should work)
  • Z370-A PRO (untested, should work)
  • Z370 GAMING PRO AC (untested, should work)
  • Z270 SLI PLUS (untested, should work)
  • Z270 KRAIT GAMING (untested, should work)
  • Z270 GAMING PRO (untested, should work)
  • Z270 TOMAHAWK (untested, should work)
  • H270 TOMAHAWK ARTIC (untested, should work)
  • Z299M-A PRO (untested, should work)
  • X299 RAIDER (untested, should work)
  • X399 GAMING PRO CARBON AC (untested, should work)
  • X399 SLI PLUS (untested, should work)
  • X299M GAMING PRO CARBON AC (untested, should work)
  • Z270 XPOWER GAMING TITANIUM (untested, should work)
  • H270 GAMING M3 (untested, should work)
  • B250M MORTAR ARTIC (untested, should work)
  • B250M PRO-VDH (untested, should work)
  • B250 PC MATE (untested, should work)
  • H270 PC MATE (untested, should work)
  • 7A78 (revision >1.x, untested, should work)
  • B250M BAZOOKA OPT BOOST (untested, should work)
  • H310M PRO-VL (untested, should work)
  • B360M MORTAR TITANIUM (untested, should work)
  • B360M PRO-VDH (untested, should work)
  • B360M BAZOOKA (untested, should work)
  • H310M PRO-VHL (untested, should work)
  • 7B30 (untested, should work)
  • B360I GAMING PRO AC (untested, should work)
  • MPG Z390I GAMING EDGE AC (untested, should work)
  • MAG Z390M MORTAR (untested, should work)
  • Z390-A PRO (untested, should work)
  • Z390 PLUS? / 7C22 (untested, should work)
  • 7C24 (untested, should work)
  • 7C01 (untested, should work)
  • B450A-PRO (untested, should work)
  • B450M GAMING PLUS (untested, should work)
  • B350M PRO-VDH (untested, should work)
  • X470 GAMING PLUS MAX (untested, should work)

How to build

  1. Install Visual Studio 2019 with C++ desktop development tools, C# and WPF support. The project is currently set to use the Windows 10 SDK build 17663, but it should work with any other.
  2. Open the solution (MSIRGB.sln)
  3. Select debug/release target & build.

License

The code is licensed under the ISC license - the same one that nagisa/msi-rgb uses. You're free to use, modify, redistribute and even use it in any commercial projects so long as you keep the copyright notice. Be aware that this means I provide no warranty whatsoever should your motherboard malfunction.