Hallo allemaal,
Ik ben de trotse bezitter van een Dell Alienware AA18250. Dit is een vlaggenschip laptop die officieel alleen Windows zou ondersteunen.
Sinds kernel 7.0 en nieuwer wordt de hardware van deze machine volledig ondersteund, op de LED-verlichting na. Ik heb met AI een complete tutorial geschreven waarvan het resultaat is dat alle LED-verlichting zal werken, met de standaard Alienware-blauwe kleur.
Ik hoop dat iemand anders er wat aan heeft. Ik deel deze waardevolle kennis om de gemeenschap nog sterker te maken en andere mensen pijn en moeite te besparen dit werkend te krijgen.
# AlienFX on Ubuntu 26.04 and later: Alienware 18 Area-51 Lighting Guide
Oct 18, 2026 · @John Doe
## Before you start
By the end, your keyboard, rear light bar, lid logo and touchpad glow solid Alienware blue at 80% brightness, every time the laptop starts or wakes up. You'll use **AlienFX LEDs**, a free Linux lighting tool whose command is `alienfix`. Its built-in default colour is exactly the blue you want (`#005aff`).
**Tested on this exact laptop.** Every step and every Terminal output below comes from an Alienware 18 Area-51 (AA18250) running Ubuntu 26.10, on 18 October 2026. Out of the box, the tool doesn't know this model and lights only a sliver of the rear bar. Step 4 fixes that with two tiny patches and a light map; it's the step that makes everything work. Step 5 lights the keyboard with one command, skipping the tool's key-mapping app.
**What you need**
- Ubuntu 26.10 installed and connected to the internet
- Your login password (Ubuntu asks for it when installing)
- About 20 minutes
**Three tricks you'll use throughout**
- Open a Terminal with **Ctrl + Alt + T**.
- Paste into the Terminal with **Ctrl + Shift + V** (plain Ctrl + V doesn't work there). Copy each grey command box exactly, paste it, press **Enter**, and wait for the prompt to come back before the next one.
- When Ubuntu asks for your password in the Terminal, nothing appears as you type. That's normal: type it and press Enter.
## Step 1: Check that Linux can see your light controllers
This 10-second check tells you whether the rest of the guide will work. Paste:
```bash
lsusb | grep -i -E "187c|0d62"
```
On the AA18250 it printed these two lines:
```text
Bus 003 Device 002: ID 187c:0551 Alienware Corporation AW-ELC
Bus 003 Device 003: ID 0d62:6abc Darfon Electronics Corp. Keyboard
```
- The **`187c:`** line is the controller for the rear light bar, lid logo and other case lights.
- The **`0d62:`** line is the keyboard's lighting chip.
See both? Go to Step 2. See nothing at all? Jump to Troubleshooting before installing anything.
## Step 2: Install AlienFX LEDs
Run these one at a time. The first two install the small helpers the tool needs; the next three download the tool and install it.
1. Refresh Ubuntu's package list:
```bash
sudo apt update
```
2. Install the helpers (type **Y** and press Enter if asked):
```bash
sudo apt install git python3-gi gir1.2-gtk-4.0 gir1.2-adw-1
```
3. Download AlienFX LEDs into your home folder:
```bash
cd ~ && git clone
https://github.com/Zeecka/alienfx-leds.git ```
4. Go into the downloaded folder:
```bash
cd ~/alienfx-leds
```
5. Install it (asks for your password):
```bash
./install.sh
```
The last lines should look like this:
```text
Created symlink '/etc/systemd/system/multi-user.target.wants/alienfixd.service' → '/etc/systemd/system/alienfixd.service'.
installed; manifest: /usr/local/share/alienfix/MANIFEST (80 entries)
```
The **Created symlink** line means the lighting service, `alienfixd`, now starts at every boot. The **installed** line confirms all files are in place.
Skip the project's optional GNOME top-bar toggle: it supports GNOME up to version 50, and Ubuntu 26.10 ships GNOME 51. Everything in this guide works without it.
## Step 3: Check that AlienFX found your lights
No extra permissions or user groups are needed: the tool deliberately avoids them, and instead Ubuntu shows a password pop-up when you change a setting. Just confirm it found your hardware:
```bash
alienfix models
```
It prints a long list of known models. The line that matters is the first one; on the AA18250 it read:
```text
product name: Alienware 18 Area-51 AA18250 controllers: keyboard, elc
```
That means the tool read your exact model, and can reach both chips from Step 1 (`keyboard` and `elc`, the case-light controller).
Now list the case lights it can control:
```bash
alienfix zones
```
On the AA18250 it printed (effect lists shortened):
```text
model: Unknown model (generic) (untested)
elc0 Light 0 (AW-ELC) static/pulse/morph/… not verified
elc1 Light 1 (AW-ELC) static/pulse/morph/… not verified
elc2 Light 2 (AW-ELC) static/pulse/morph/… not verified
elc3 Light 3 (AW-ELC) static/pulse/morph/… not verified
```
**Unknown model (generic)** is the catch. For laptops it doesn't recognise, the tool only drives 4 lights. On the Area-51 that lights just a small section on the left of the rear bar, and the logo stays dark. Step 4 fixes this.
## Step 4: Teach AlienFX all of your laptop's lights
Your Area-51 has far more lights than the 4 the tool assumes. The rear bar sits on lights 0–31, and the logo and touchpad sit higher (part of the logo is light 45). This step makes the tool drive every light from 0 to 255, all in blue. It's two small patches to your downloaded copy plus a light map for your model. They're installed the normal way, so the uninstaller still removes everything.
**1. Go to the tool's folder:**
```bash
cd ~/alienfx-leds
```
**2. Patch 1: let the tool send more than 26 lights at once.** The tool packs one colour message with at most 26 lights; with more, it would crash. This splits long lists into several messages. Paste the whole block, from `python3` to `EOF`:
```bash
python3 - <<'EOF'
from pathlib import Path
p = Path("src/alienfix/protocol.py")
old = " out.append(_elc(0x03, 0x27, r, g, b, 0x00, len(ids), *ids))\n"
new = (" for k in range(0, len(ids), 26): # at most 26 lights fit in one message\n"
" out.append(_elc(0x03, 0x27, r, g, b, 0x00, len(ids[k:k + 26]), *ids[k:k + 26]))\n")
s = p.read_text()
if new in s:
print("already patched")
elif old in s:
p.write_text(s.replace(old, new)); print("patched")
else:
print("NOT FOUND: tell Claude")
EOF
```
It prints:
```text
patched
```
**3. Patch 2: allow light numbers up to 255.** The tool normally refuses anything above 31:
```bash
python3 - <<'EOF'
from pathlib import Path
p = Path("src/alienfix/models.py")
s = p.read_text()
s2 = s.replace("MAX_ZONES = 32\n", "MAX_ZONES = 256\n").replace('MAX_INDEX = {"elc": 31, "wmi": 7}\n', 'MAX_INDEX = {"elc": 255, "wmi": 7}\n')
if 'MAX_INDEX = {"elc": 255' in s and "MAX_ZONES = 256" in s:
print("already patched")
elif 'MAX_INDEX = {"elc": 255' in s2 and "MAX_ZONES = 256" in s2:
p.write_text(s2); print("patched")
else:
print("NOT FOUND: tell Claude")
EOF
```
It also prints **patched**.
**4. Write the light map for your model.** This tells the tool your laptop has lights 0–255 and prints nothing:
```bash
python3 - <<'EOF' > data/models/alienware-18-area-51-aa18250.json
import json
zones = [{"id": f"z{i}", "label": f"Light {i} (AW-ELC)", "controller": "elc", "index": i, "group": "chassis", "verified": False} for i in range(256)]
print(json.dumps({"id": "alienware-18-area-51-aa18250", "name": "Alienware 18 Area-51 AA18250 (test)", "dmi_product": ["Alienware 18 Area-51 AA18250"], "support": "untested", "source": "Local test: AW-ELC lights 0-255", "keyboard": {"type": "per-key"}, "zones": zones}, indent=1))
EOF
```
**5. Reinstall.** This also restarts the lighting service:
```bash
./install.sh
```
**6. Set brightness to 80% and count the lights:**
```bash
alienfix brightness 80 && alienfix zones | grep -c "AW-ELC"
```
It prints:
```text
256
```
The rear bar, lid logo and touchpad now all glow blue at 80%.
**Good to know:** the patches live in your downloaded copy of the tool. If you ever download a newer version, repeat this step; each patch prints **already patched** when it's still in place.
## Step 5: Make every key blue (no app needed)
The tool's key-mapping app only matters if you want to colour individual keys. For an all-blue keyboard, you give the tool a ready-made map covering every possible key light (0–254), then turn them all blue with one command. The map is saved through the tool's normal "import a key map" function.
Don't use `alienfix effect` for this: on this keyboard the built-in effects ignore your colours and play a rainbow.
**1. Save the script.** Paste the whole block:
```bash
cat > ~/allkeys.py <<'EOF'
import json, sys
sys.path.insert(0, "/usr/local/lib/alienfix")
from alienfix.cli import call
t = json.load(open("/usr/local/share/alienfix/chassis/alienware-m15-r7-qwerty-us.json"))
names = list(dict.fromkeys(k["name"] for k in t["keys"]))
ids = list(range(255))
keys = {n: ids[i * 3:i * 3 + 3] for i, n in enumerate(names) if ids[i * 3:i * 3 + 3]}
call("SaveProfile", "(s)", json.dumps({"version": 1, "name": "All keys blue (no key map)", "chassis": t["id"], "method": "blink", "keys": keys}))
print("key map saved:", sum(map(len, keys.values())), "lights")
EOF
```
**2. Load the map.** A password pop-up may appear:
```bash
python3 ~/allkeys.py
```
It prints:
```text
key map saved: 255 lights
```
**3. Make every key blue:**
```bash
alienfix color '#005aff'
```
The whole keyboard now glows solid blue at the same 80% brightness as the case lights.
**Good to know:** this map lights every key the same colour, but the key names in it are placeholders. Colouring single keys by name won't work with it; for that you'd need the app's blink test after all.
## Step 6: Make sure it stays on after a restart
There's nothing extra to set up: the background service saves your colours and re-applies them at every startup and after the laptop wakes from sleep. Confirm the service is set to start automatically:
```bash
systemctl is-enabled alienfixd
```
It should answer **enabled**. Now restart the laptop once. When you're back at the login screen or desktop, the rear bar, logo, touchpad and keyboard should be blue again. Also try closing the lid for a minute and opening it: the lights should come back blue after waking.
## Troubleshooting
Find your symptom in the left column and try the fix on the right.
| What you see | What to do |
| --- | --- |
| Step 1 showed no `187c` or `0d62` line | Linux can't see the light controllers, so no tool can light them. Update the laptop's BIOS from Dell's support site, then try Step 1 again. |
| `alienfix: command not found` | The install didn't finish. Run `cd ~/alienfx-leds && ./install.sh` again and look for **installed; manifest:** at the end. |
| A password pop-up appears when you change a colour | Normal. It protects your keyboard from other programs. |
| Only a small left part of the rear bar is lit, logo dark | Step 4 isn't active. Check with `alienfix zones \| grep -c "AW-ELC"`: it must print **256**. If it prints 4, redo Step 4. |
| A patch in Step 4 prints **NOT FOUND** | A newer version of the tool changed the code the patch edits. Don't continue; ask on the project's issue page (below). |
| Lights are much brighter than before | Something sent full-strength colours. Run `alienfix brightness 80`. |
| Keyboard stays dark, case lights are blue | Redo Step 5 (it must print key map saved: 255 lights), then run `alienfix color '#005aff'`. |
| Lights go wrong after waking from sleep | Restart the service: `sudo systemctl restart alienfixd` |
| Something else | Show the service's log with `journalctl -u alienfixd -b`. |
Still stuck? The project asks owners of unlisted laptops to report what they see. Open an issue at [github.com/Zeecka/alienfx-leds/issues](
https://github.com/Zeecka/alienfx-leds/issues) and paste the output of `alienfix models` and `alienfix zones`; that helps get the AA18250 added properly. Mention that lights 0–255 via the 0x27 colour command work on this model.
## Undo or uninstall
The uninstaller removes exactly what was installed, and nothing else. Run:
```bash
cd ~/alienfx-leds && ./uninstall.sh
```
Then delete the downloaded folder:
```bash
rm -rf ~/alienfx-leds
```
After the next restart, the lights go back to whatever the laptop does on its own.
## Sources
- [AlienFX LEDs project page](
https://github.com/Zeecka/alienfx-leds): install steps, commands, and the default blue `#005aff` (RGB 0, 90, 255) in its source code, checked 18 Oct 2026
- [AlienFX LEDs supported models](
https://github.com/Zeecka/alienfx-leds/blob/main/docs/supported-models.md)
- [AlienFX LEDs on PyPI](
https://pypi.org/project/alienfx-leds/): version 0.1.0, released 6 Oct 2026
- [Kernel bug 222002](
https://ratatoskr.run/platform-driver-x86/2026/09/17551010/t): the Linux alienware-wmi driver doesn't control lighting on the sister model AA16250
- [Ubuntu 26.10 release notes summary](
https://ubuntuhandbook.org/index.php/2026/10/ubuntu-26-10-released-with-kernel-7-3-gnome-51-amd64v3-image/): Linux 7.3, GNOME 51
- [Dell: Alienware 18 Area-51 (AA18250)](
https://www.dell.com/en-us/shop/laptop-computers/spd/alienware18area51aa18250)
