AlienFX for Alienware 13 R2

This is a reverse-engineering project to control the lights on a Dell Alienware 13 R2 laptop. This model has different light zones than the ones already configured previously.

References

The following projects were used as a reference for building this one:

• trackmastersteve/alienfx
• snooze6/hack-alienfx

Dependencies

• Java 25
• PicoCLI
• Java Does USB
• Google GSON
• Dell Alienware 13 R2 Laptop
• USB Device (VID: 0x187C, PID: 0x0527) (Alienware Corporation AW13)

Caveats

This project was only tested on a Dell Alienware 13 R2 running Arch Linux. Other operating systems may have different commands or permissions.

System Configuration Instructions

Configuring UDEV Permissions

The program needs access to a USB device which normally is not allowed. We can enable access using a UDEV rule. Please create the necessary files.

/etc/udev/rules.d/99-alienware-usb-permissions.rules

SUBSYSTEM=="usb", ATTR{idVendor}=="187c", ATTR{idProduct}=="0527", MODE="0666"

Reloading UDEV Rules

Once you have created that file, please reload the UDEV rules with the following commands.

sudo udevadm control --reload
sudo udevadm trigger

Usage

To use this project, please run a Java command.

$ java --enable-native-access=ALL-UNNAMED -jar AlienFX.jar <options>

Make sure to replace "AlienFX.jar" with the actual name of the jar file. The list of available options is below.

Examples

List Possible Options

You can view all available options using the help command.

java --enable-native-access=ALL-UNNAMED -jar AlienFX.jar help

Set keyboard lights to blue

This will set the entire keyboard to full blue RGB(0, 0, F)

java --enable-native-access=ALL-UNNAMED -jar AlienFX.jar set-color --zone KEYBOARD_ALL --color 0,0,F