🌙 Dark Mode

💣 CS2Hue: Hue Bomb Control for CS2

View on GitHub

📚 Table of Contents

💡 What is CS2 Hue?

CS2Hue syncs your Philips Hue lights with bomb events in CS2.
Reacts to plants, defuses, wins/losses — making your room part of the action!

Download from GitHub

🎮 Features

🚀 Quickstart

  1. Download the app from GitHub Releases
  2. Unzip it anywhere you like
  3. Copy gamestate_integration_cs2hue.cfg to your CS2 config folder: 
    C:\Program Files (x86)\Steam\steamapps\common\Counter-Strike Global Offensive\csgo\cfg
  4. Launch the application
  5. Enter your Hue Bridge info (IP, API key, Light IDs)
  6. Hit Start 🎯

🔬 How to Find Your Hue Info

1. Hue Bridge IP

  1. Make sure to be on the same network as your hue bridge
  2. Visit https://discovery.meethue.com/
  3. Copy your IP address.
    Hue Bridge IP discovery example

2. API Key

  1. Now use the copied IP to open the following link in your Browser: http://YOUR_BRIDGE_IP/debug/clip.html
  2. Enter the following into the URL field: 
    /api
  3. Enter this into the Message Body field: 
    {
    "devicetype":"CS2HUE#device"
}

    It should look like this:

    API key request
  4. Now Press the Button on the Bridge.
  5. After you pressed the button click on "POST" on the webpage.
  6. Now the Command Response field should give you your API key. Make sure to copy it
    Copy your API key

3. Light IDs

  1. Open the same link again, where you retrieved your API key. http://YOUR_BRIDGE_IP/debug/clip.html
  2. Now use your copied API key to type in the following into the URL field: 
    /api/YOUR_API_KEY/lights
    It should look like this:
    Request light info
  3. Now press the GET button.
  4. You will now get a lot of Information in the Command Response.
  5. Look for the name that you gave your light (You've done that on the first setup).
  6. Now scroll a bit up. You find the ID of your light, right above the name.
  7. In the following Screenshot my lights name is "PC-Links". When I scroll up, it has the ID 14.
    Light ID example
  8. Copy the IDs of every light that you want to be synced with CS. In my case the IDs are 13 and 14.
  9. Input the IP of your bridge, the API-key and the IDs of the lights into the fields of the GUI.
    Example Config
  10. Don't forget to save the config by clicking on the 💾 Save Config button.
  11. Now test the lights by clicking on the test button of one of the colors.
    If the light shines, then you've done it correctly, if not, then take a look at the log box.
  12. If you've done everything correctly, then it should look like this:
    Logbox shows color test

⚙️ Configuration Overview

Key Default Value Description
BRIDGE_IP "192.168.1.10" The IP address of your Philips Hue Bridge.
API_KEY "YOUR_API_KEY_HERE" Your authorized Hue API key.
SERVER_HOST "127.0.0.1" Host address for the local server.
Must match the IP in your gamestate_integration_cs2hue.cfg.
SERVER_PORT 8080 Port the server listens on. Must match the port in your gamestate_integration_cs2hue.cfg.
LIGHT_ID "0, 1, 2" Comma-separated Hue light IDs to control.
SHOW_BOMB_TIMER false Show extra bomb countdown logs when planted.
HTML_LOG false Save a session log as an HTML file under /logs/.
DEBUG_MODE false Enable verbose debug logging in console.
LIVE_LOG_LINES 1000 Maximum log lines to store for the live HTML log viewer.

💡 You can configure all of these inside the app or edit config.json manually (not recommended for beginners).

Example config.json:

{
    "BRIDGE_IP": "192.168.1.10",
    "API_KEY": "YOUR_API_KEY_HERE",
    "SERVER_HOST": "127.0.0.1",
    "SERVER_PORT": 8080,
    "LIGHT_ID": "0, 1, 2",
    "SHOW_BOMB_TIMER": false,
    "HTML_LOG": false,
    "DEBUG_MODE": false,
    "LIVE_LOG_LINES": 1000
}
⚠️ Important: The values of SERVER_HOST and SERVER_PORT in your configuration must exactly match the ones defined in your gamestate_integration_cs2hue.cfg file — otherwise, CS2 won’t be able to send data to the app.

💡 You can also set SERVER_HOST to the IP address of another local device on your network. As long as the app is running on that device and your firewall allows the connection, this setup will work.

📓 Logs

CS2Hue includes a powerful built-in logging system that helps you track all game and light events, troubleshoot errors, and optionally export logs for deeper analysis.

✨ Key Features

⚠️ Note: The live log view only works while the sync is active. Once you stop the sync, the view stops updating and the log can no longer be saved.

📁 HTML_LOG Option

HTML_LOG in your config.json controls whether logs are saved to disk. These are completely separate from the live log and can be reviewed later.

If enabled, session logs are flushed to HTML files inside the /logs/ directory. A new file is created each day, named like: 2025-04-29-log.html

📍 HTML Log Viewer Features

🧰 Log Output in App

The app window also shows a live log box under the 📄 Log section.

🛠️ Developer Notes

🧠 FAQ

💡 My lights don't react! What should I check?

🧨 Can I add custom bomb timings??

Yes, configure them in the app's Bomb Settings UI.

🚫 Can I get a VAC ban for using CS2Hue?

🧹 How It Works

💬 Credits

Project by Dustin Ringewald.

Special thanks to: