Case study

alienware-m15-rgb: Linux control of the m15 R2 lighting controllers

alienware-m15-rgb implements Linux control of the Alienware m15 R2's per-key keyboard and chassis lighting through HID reports. Its protocol notes describe the Darfon API_V5 feature-report sequence and AW-ELC API_V4 output reports, including separate handling for the power-button light.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06
Evidence class: C2 code & docs, no demo or download

Stars: 0
Last commit: 2026-06-22
Language: Python
License (GitHub): GPL-3.0

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code, documentation and a download method observed; no demo found.
Checked: 2026-11-08

How evidence classes are assigned

Requirements & limits

Prerequisites: An Alienware m15 R2 with the documented Darfon and AW-ELC controllers and Linux hidraw access are required.
Prerequisites: A udev rule enables access without root; wallpaper matching additionally requires ImageMagick.
Limits: Other notebooks using the same keyboard protocol are described as possible but unconfirmed.
License: GPL-3.0-or-later license.

Cite

BibTeX

@misc{alienware-m15-rgb-case,
  title = {{alienware-m15-rgb: Linux control of the m15 R2 lighting controllers}},
  howpublished = {\url{https://github.com/Louisreed/alienware-m15-rgb}},
  url = {https://github.com/Louisreed/alienware-m15-rgb},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/alienware-m15-rgb-case/}}
}

Plain text

alienware-m15-rgb: Linux control of the m15 R2 lighting controllers. https://github.com/Louisreed/alienware-m15-rgb (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/alienware-m15-rgb-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

docs/PROTOCOL.md GitHub · Louisreed/alienware-m15-rgb · Revision 3a7bd44
README.md GitHub · Louisreed/alienware-m15-rgb · Revision 3a7bd44