phue-racing-flags

Use your Philips Hue lights as Racing Flags.

Explore the docs »

Report Bug · Request Feature



Hey 👋 I'm Tim and I love to develop free and open source apps like phue-racing-flags.
All donations are greatly appreciated and directly support my work.

Table of Contents

1. About The Project
   • Built With
2. Supported Systems and Racing Simulations
3. Local Development
   • Prerequisites
   • Installation
   • Run the app
4. Usage
5. License
6. Contact
7. Acknowledgements
8. Disclaimer

About The Project

One Friday evening I thought to myself that it would be pretty cool to use my Philips Hue lights as indicators for the racing flags inside of Assetto Corsa Competizione. As no app was available to achieve this, I decided to take matters into my own hands and create one.

Built With

• Python
• Electron
• Vue.js

Supported Systems and Racing Simulations

The app is designed for Windows and currently supports the following racing simulations:

• Assetto Corsa
• Assetto Corsa Competizione
• iRacing

Local Development

To get a local development copy up and running, follow these simple steps.

Prerequisites

• Python
• Node.js / npm

Installation

• Clone the repo

  git clone https://github.com/TUnbehaun/phue-racing-flags.git

• Install Eel via pip

  pip install eel

• Install Electron via npm

  npm install

Run the app

• Start the GUI

   python web.py

Usage

To just use the app itself without setting up a local development copy, you can follow these simple steps:

1. Download the latest .exe file from here: https://github.com/TUnbehaun/phue-racing-flags/releases/latest/download/phue-racing-flags.exe
2. If you have already used a previous version, make sure to delete any existing phue-rf-save.json or prf-save.json files, to ensure compatibility with the newest version.
3. Run the .exe file

Once the app is started, you can use it the following way:

1. Enter the IP Address of your Philips Hue Bridge under Settings -> Philips Hue -> Bridge IP. (You can find the IP Address of your Bridge in the interface of your Router)
2. Press the (hardware) link button on your Philips Hue Bridge and then within 30 seconds hit the "Connect" button next to the Bridge IP input field. (Pressing the (hardware) link button on your Philips Hue Bridge is only necessary for the very first time you connect the app to a new Bridge)
3. You should be able to choose one or multiple of your lights under Settings -> Philips Hue -> Lights to use as the Racing Flag Light(s)
4. Adjust brightness if needed.
5. Custom colors for your lights can be set under Settings -> Flags -> Flag Colors respectively.
6. Test your color configuration by using the Test buttons next to each flag.
7. On the main view you can use the cards to switch syncing between Assetto Corsa, Assetto Corsa Competizione or iRacing.
8. To start syncing the Racing Flag Light(s) with your simulation's race flag click "Start" in the live sync banner.
9. To stop syncing the Racing Flag Light(s) click "Stop".

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Tim Unbehaun - tim@dltu.de

Project Link: https://github.com/TUnbehaun/phue-racing-flags

Acknowledgements

• phue
• Eel
• PyInstaller
• pyirsdk
• hue-python-rgb-converter

Disclaimer

This app is not an official product endorsed by Philips, Kunos Simulazioni or iRacing and I am in no way affiliated with them. The images used in the main screen of the app are in-game screenshots from the respective simulations and I explicitly asked for permission, before I included them.

"Hue Personal Wireless Lighting" is a trademark owned by Koninklijke Philips Electronics N.V.

"Assetto Corsa" and "Assetto Corsa Competizione" are trademarks owned by Kunos Simulazioni S.r.l.

"iRacing" is a trademark owned by iRacing.com Motorsport Simulations, LLC