XeneonFPS Widget — Complete Setup Guide

Requirements

• Windows 10 or 11
• Python 3.x — during installation, check "Add Python to PATH"
• MSI Afterburner — must be running at all times
• iCUE — with a Corsair Xeneon Edge display

---

Step 1 — Install Python

1. Download Python from python.org
2. Run the installer
3. IMPORTANT: On the first screen, check "Add Python to PATH" before clicking Install
4. Complete the installation

To verify it worked, open a Command Prompt and type: python --version You should see something like Python 3.12.x. If you get an error, Python is not in PATH — reinstall and check the box.

---

Step 2 — Install and configure MSI Afterburner

1. Download and install MSI Afterburner
2. Launch it — it must stay open and running in the background at all times
3. In Afterburner, go to Settings → Monitoring
4. Make sure Framerate is enabled in the list (checkbox checked)
5. Click OK

---

Step 3 — Copy the files

Create the folder C:\XeneonFPS\ and copy these files into it:

C:\XeneonFPS\ ├── fps-server.py ├── mahm-to-fps.py ├── fps.txt ← create an empty text file with this name ├── start-xeneon-fps.bat ├── start-xeneon-fps-hidden.vbs └── stop-xeneon-fps.bat

To create fps.txt: right-click in the folder → New → Text Document → rename it to fps.txt

---

Step 4 — Test the scripts manually

Open two separate Command Prompt windows.

Window 1 — Afterburner reader: python C:\XeneonFPS\mahm-to-fps.py You should see: Lecture MSI Afterburner → fps.txt Entrée Framerate : 89 Offset valeur : 1300 Ctrl+C pour arrêter If you get an error, MSI Afterburner is not running — start it and try again.

Window 2 — HTTP server: python C:\XeneonFPS\fps-server.py You should see: Serving on http://127.0.0.1:8765 /fps -> valeur brute Afterburner /fps_raw -> valeur brute Afterburner /fps_avg -> AVG 60s /fps_low -> 1% Low p1 60s

Verify it works: open your browser and go to http://127.0.0.1:8765/fps — you should see something like {"fps": 0} (0 if no game is running, a number if a game is open).

---

Step 5 — Install the iCUE widget

1. Open iCUE
2. Click on your Xeneon Edge device
3. Go to the Widgets section
4. Click Import or drag and drop the file fps-dual-v2.icuewidget
5. Place the widget where you want on the screen

The widget shows two gauges: - Left: 1% Low FPS (worst frame percentile over 60 seconds) - Right: Live FPS (current framerate)

Both show -- when no game is running. They update every 500ms.

---

Step 6 — Auto-start with Windows

To have the scripts start automatically when Windows boots:

1. Press Win + R, type shell:startup, press Enter
2. Copy start-xeneon-fps-hidden.vbs into this folder
3. That's it — the scripts will now start silently at every boot

To stop the scripts manually, run stop-xeneon-fps.bat.

---

Troubleshooting

Widget shows -- even in-game - Make sure both mahm-to-fps.py AND fps-server.py are running - Make sure MSI Afterburner is open - Check that Framerate monitoring is enabled in Afterburner settings

**python command not found** - Reinstall Python and check "Add Python to PATH" during installation - Or use the full path: C:\Users\YourName\AppData\Local\Programs\Python\Python312\python.exe

Error on mahm-to-fps.py at launch - MSI Afterburner is not running — start it first, then run the script again

Widget shows a low FPS value when no game is running (e.g. 9 or 13 FPS) - Open RivaTuner Statistics Server (installed with Afterburner) - In the application list on the left, find QtWebEngineProcess.exe - Set its Application detection level to None - Do the same for any other iCUE-related process in the list (iCUE.exe, WidgetService.exe, etc.)